The Karma Yoga CLI · public alpha

You direct.
The crew does the work.

The Karma Yoga CLI runs Claude Code and Codex as a crew in one terminal session. You talk to the manager on the left. It starts agents on the right, sends them work and knows who is busy.

Install the alpha What the CLI does

Version 0.1.0-alpha.1 for macOS. One line installs it.

karma attach reports

manager claudeprotected

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

● I will set up a crew for this.

$ karma agent create builder

$ karma crew tell builder "Add the export"

$ karma agent create tester

$ karma crew tell tester "Test the export"

$ karma agent create reviewer

$ karma crew tell reviewer "Review it"

$ karma agent create docs

$ karma crew tell docs "Document it"

$ karma crew status

builder idle tester idle

reviewer busy docs busy

›

builder codexidle

› Add the export

Reading src/reports

Adding an Export CSV button

Writing exportCsv for the report rows

Export added to the reports page.

›

tester codexidle

› Test the export

Waiting for the export button

Writing tests for empty and large reports

6 tests pass.

›

reviewer claudebusy

› Review it

Waiting for builder and tester

Reviewing the export diff

›

docs claudebusy

› Document it

Adding Export to the reports help page

›

One window. A manager on the left.
A crew on the right.Scroll to assemble the crewSee how it works

How a session works

Say what you want.
The manager runs the crew.

The Karma Yoga CLI is one command for every agent session on your Mac. Each session is one window with one fixed layout.

Start a session.
karma new creates a session from a template. A protected manager sits on the left. The agents it starts stack on the right.
Talk to the manager.
The manager is a real Claude Code or Codex session. Tell it what you want done.
Let it run the crew.
Ask the manager to create agents and message them, or run the same commands yourself. karma crew status shows who is busy or idle and which messages are still waiting.

One fixed layout

The manager stays put.
The crew comes to it.

A protected manager

The manager is always the left pane, and it is protected. karma kill is the only way to stop the session.

A column that scrolls

Every agent pane is 20 rows tall. The column on the right grows past the screen and scrolls, up to 12 agents by default, while the manager stays where it is.

Claude Code and Codex, in any mix

Each agent is the real tool, running as it always does. A session can be all Claude, all Codex or both.

Messages that arrive

A message to an agent is sent in one step and comes back with a receipt. If the agent is busy, the message waits and is delivered when its pane is ready.

Built to keep going

The same conversation after a restart.

Each agent keeps its conversation, so a restart or a parked agent picks up where it left off.

Agents come back

When an agent's process exits, its pane stays where it is and the agent starts again in the same conversation. It restarts up to three times within two minutes, then it is parked and reported.

Park and bring back

karma agent deactivate parks an agent and keeps its conversation. karma agent reactivate brings it back in the same conversation.

Commands that stay out

Typing /clear or /new in a session pane is blocked, and /reset in Claude Code. The pane shows that it is blocked in this session.

After a reboot coming

Rebuilding sessions after a reboot is coming.

Your tools

Your Claude Code and Codex, run as a crew.

The tools you have

The Karma Yoga CLI runs the claude and codex on your PATH. karma doctor checks both and prints their versions.

A folder of their own

Agents keep their settings and transcripts in ~/.karmayoga/karma/. Your own ~/.claude and ~/.codex stay as they are.

One file

The Karma Yoga CLI ships as one universal binary for Intel and Apple silicon, about 7 MB, written in Rust. Sessions keep running when you close the terminal.

One background process

One server runs in the background and owns every pane. Everything else is a command that starts, does its job and exits.

Where it stands

The alpha is out.

Version 0.1.0-alpha.1 runs on macOS. Linux and Windows are not supported yet.

done
The session serverSending as one step, pane identity, recovery, held messages, the input guard, the scrolling agent column and the fixed layout are done.
done
Claude and Codex modulesEverything that depends on how each tool behaves.
done
karma crew and karma agent in RustThe crew commands, built on the server with no extra background process.
alpha
The Karma Yoga CLI binaryOne file with new, attach, ls, kill, karma agent, karma crew and doctor.
coming
Usage, reboot restore, the Mac appComing after the alpha.

Work you direct, not work you do.

Install the alpha in one line, then read how a first session goes.

Install the alpha Read the guide

You direct.The crew does the work.

Say what you want.The manager runs the crew.

Start a session.

Talk to the manager.

Let it run the crew.

The manager stays put.The crew comes to it.