Get Started in Seconds

Choose the installation method that suits you best. Using a package manager is recommended for easy installation and automatic updates.

Installation Methods

macOS

Install via Homebrew (Recommended)

1. Add the tap (one-time setup):

brew tap kacperzielinskidev/tap

2. Install getctx:

brew install getctx

Updating getctx in the future:

brew upgrade getctx

Linux

Multiple installation options available

Option A: Debian, Ubuntu, and derivatives (via .deb package)

This method uses your system's native package manager and is recommended for Debian-based distributions.

curl -sL -o /tmp/getctx.deb $(curl -s https://api.github.com/repos/kacperzielinskidev/getctx/releases/latest | grep "browser_download_url.*amd64.deb" | cut -d '"' -f 4)
sudo dpkg -i /tmp/getctx.deb

Option B: Using Homebrew on Linux

If you already use Homebrew on Linux (Linuxbrew), follow the same instructions as for macOS:

brew tap kacperzielinskidev/tap
brew install getctx

Windows (Scoop)

Install via Scoop package manager

1. Add the bucket (one-time setup):

Open PowerShell and run:

scoop bucket add kacperzielinskidev https://github.com/kacperzielinskidev/scoop-bucket.git

2. Install getctx:

scoop install getctx

Updating getctx in the future:

scoop update getctx

Go Install

For Go developers

If you have Go installed, you can install getctx directly:

go install github.com/kacperzielinskidev/getctx/cmd/getctx@latest

The getctx binary will be placed in your $GOPATH/bin directory.

Manual Installation

Download pre-compiled binaries

You can download a pre-compiled binary for your operating system directly from GitHub:

  1. Go to the Latest Release page
  2. Download the appropriate archive (.zip or .tar.gz) for your OS and architecture
  3. Extract the archive
  4. Move the getctx (or getctx.exe) executable to a directory in your system's PATH (e.g., /usr/local/bin on Linux)

Quick Start

Step 1: Run getctx
getctx

This launches the interactive TUI in your current directory.

Step 2: Select files

Navigate with arrow keys, press Space to select files, or CTRL+A to select all.

Step 3: Save and exit

Press q to save your selections and generate the context file.

Step 4: Use the output

Your aggregated context is saved to context.txt by default.

Command Line Options

-o <filename>Specify custom output file
getctx -o my-context.txt
--debugEnable debug logging to debug.log
getctx --debug

Next Steps

Learn about all the features and keyboard shortcuts in the documentation.

Read Documentation