Quickstart

What is Capacitor

Capacitor records every coding-agent session your team runs — Claude Code, Codex, Cursor — and surfaces them in a real-time dashboard. A small CLI installs hooks into your agents that stream each session to your tenant as it runs. From there you can replay a session, recap it, hand it to another agent, share it, and use it to review the pull requests it produced — with full transcripts queryable from the CLI, the dashboard, and from inside the agent itself.

Prerequisites for this Quickstart

• A Capacitor server URL of the form https://<your-org>.kcap.ai.
• Membership of that GitHub organization.
• Claude Code and/or Codex installed on your machine.

1. Install the GitHub App

Connect Capacitor to your GitHub organization.

Note

If a teammate has already installed the GitHub App for your organization, skip ahead to step 2.

1. Open the app listing:

   https://github.com/apps/kurrent-kcap

2. Click Install and choose the organization that matches your Capacitor server.

When the install finishes, your server is live and anyone in the organization can sign in.

Note

Capacitor asks only for read access to metadata — repository names, members and teams, pull-request titles. It never sees or changes your code.

2. Install the CLI

Install the Capacitor CLI and run its setup wizard.

1. Install the CLI and run the setup wizard:

   npm install -g @kurrent/kcap
   kcap setup

   The wizard signs you into GitHub, finds your Capacitor server, and installs hooks for Claude Code and Codex.

2. Confirm it worked:

   kcap whoami
   kcap status

   You should see your GitHub identity and a reachable server.

3. Trust the Codex hooks: open Codex, run /hooks, and trust each kcap entry.

Caution

If you use Codex in a later step, and Codex won’t fire its Capacitor hooks until you trust them.

3. Import your history to Capacitor

Import your past coding-agent sessions into Capacitor.

1. Start the import:

   kcap import

2. At What would you like to import?, choose Specific repository, then pick a repo you’ve worked in from the list.

3. Read the summary it prints and confirm. Your past sessions upload.

Note

Only repos with captured sessions appear in the list, so your pick always has something to import. You can run the command again at any time — it only uploads what’s missing.

4. Open a session and copy its ID

Pick a past session in the dashboard and copy its ID.

1. Open your Capacitor server in a browser and select the Sessions tab:

   https://<your-org>.kcap.ai

2. Open any session, and note which agent it ran with — you’ll hand it to a different agent next.

3. Click the copy icon beside the session title.

Note

Each session is tagged with the agent it ran with (Claude Code or Codex), its repository, and author.

5. Hand the session to another coding agent

Hand the copied session off to a different agent.

Note

This step moves a session between agents, so you’ll need both Claude Code and Codex installed.

1. In the session’s repository, start the other agent — Codex if the session ran in Claude Code, Claude Code if it ran in Codex:

   cd <the-repo>
   codex            # or: claude

2. Prompt it to pick up where the session left off, pasting the ID you copied:

   Recap session <paste-the-id> and continue where it left off.

3. Continue working as if it were the same agent — it picks up with the prior session’s decisions and ruled-out approaches already in context.

6. Share the session with a teammate

Give a teammate access to the session from the dashboard.

1. Open the session in the dashboard and click the link 🔗 icon next to the session name.
2. Under Teams & people, choose a teammate or a GitHub team from your organization.

Note

They can now open the session — and, as you’ll see in the next step, query its transcript from their own machine.

7. Review a pull request

Review a pull request using the sessions that produced it.

1. In the dashboard, find a session that’s linked to a pull request — the PR shows in the session’s metadata. Copy that PR’s URL from GitHub.

Note

No PR-linked sessions among the ones you imported? This is the step to come back to once you’ve run a session whose branch becomes a pull request.

2. In the CLI, run:

   kcap review <pr-url>

3. Ask questions about the change to understand the reasoning behind it — the answers come from the session transcripts, not just the diff.

What you’ve done

You’ve taken one session through the entire Capacitor loop: captured, imported, handed off, shared, and used to review real work.

Each step has a page that goes deeper:

• Your tenant — installing the GitHub App and the admin setup.
• Install the CLI — the full setup wizard.
• Import your history — other import scopes.
• Session recap — recaps in the terminal and the in-agent skill.
• Visibility & sharing — every way to control who sees a session.
• PR review — the MCP tools behind the review.

And to go beyond the tutorial:

• The dashboard — what each tab shows.
• Session recall — search every session from inside your agent, not just one pull request’s.
• CLI commands — the full command surface.