Karma Yoga Get the CLI

Get started with Karma Yoga CLI

Karma Yoga CLI runs a fleet of Claude Code, Codex and Pi agents. It is the core behind the Karma Yoga app, so technical users can use it directly, and new features arrive here first. See the technical details, or follow the steps below to start using Karma Yoga CLI from your favorite terminal app. We recommend Ghostty.

You need a Mac or Linux machine (Windows through WSL2) and at least one of Claude Code, Codex or Pi, run under your own accounts at no added cost. Step 2 installs one if you have none.

1. Install Karma Yoga CLI

Open Terminal and install with Homebrew.

brew install karmayogasoftware/tap/karma

Check that it installed.

karma --version

Other ways to install

Without Homebrew on macOS or Linux, run the install script.

curl -fsSL https://getkarmayoga.com/install.sh | sh

You can also download an archive from GitHub Releases.

Supported on macOS, Linux and Windows through WSL2.

2. Install a tool and sign in

Already use Claude Code, Codex or Pi? Run karma doctor and go on to step 3.

karma doctor

Otherwise, install at least one tool and sign in to it. Karma Yoga CLI works best with more than one, so each agent can run on the tool that suits its part.

karma tools install claude
karma tools login claude

3. Set up this computer

karma init sets up this computer once. It uses the tools that are installed and signed in. To choose, add --tools with claude, codex, pi or a list such as claude,codex.

karma init

If something fails, it stops and names the command that fixes it.

4. Start your first session

A session is a terminal where a manager agent on the left runs the other agents on the right, and it keeps going when you close the window. Give it a name for one area of your work, such as reports.

karma new reports

The session works in your current directory. Run from your home directory, it asks for a folder instead, and Enter creates karma-reports there. To work in karma-reports under your home directory from anywhere, add --default-dir.

karma new reports --default-dir

karma new takes you into the session as soon as its panes are up, and the agents finish starting while you watch.

5. Give the manager its first job

Type in the manager's pane and give it the whole job, not one step at a time.

Add a CSV export to the reports page. Build it, test it, have it reviewed.

The work does not have to be code.

Read the ten PDFs in this folder, pull the invoice totals into a spreadsheet, and have it checked.

A new session starts with a builder, a reviewer and a copy-writer, and the manager gives each one its part. You can talk to any agent by moving the pointer into its pane.

6. Leave, and come back later

Press Ctrl-\ to detach, or close the terminal. The work keeps going. From a terminal outside the session, list your sessions and open one again. After a reboot the session comes back by itself where the service runs, and karma open reports takes you in.

karma ls
karma open reports

karma o reports is short for karma open reports.

After that

Agents use your own account for each tool. karma usage shows account limits, when they reset and what each agent used, and karma machine shows CPU load, memory, disk space and what each session uses.

karma usage
karma machine

karma update installs the newest release and keeps your agents on their conversations. When Homebrew installed Karma Yoga CLI, it upgrades through Homebrew.

karma update

The changelog lists every release, and karma --changelog prints the last five from the terminal.

karma --changelog

If something goes wrong, tell us from the terminal. The report includes your text and diagnostic details such as versions and recent log lines. You can also write to hello@getkarmayoga.com.

karma feedback --text "What went wrong"