Cards

Delegate the coding, not the understanding.

Cards is a local-first extension that organizes coding-agent activity into durable, Git-backed work directories. It sits between you, your local repository, and your coding agent (such as Claude Code or Codex), keeping your agentic workflows legible, isolated, and under your control.

The Core Workflow

Coding agents write faster than you can read. When a session ends or a terminal closes, you often lose the plan, the transcripts, and the rationale behind the edits. Cards prevents this context loss:

1. Create a Card: Groups your task description, plan, transcripts, and commits into a local Git repository on your disk (~/.cards/cards-repos/<card-id>/).
2. Define the Task: You write the description and plan in CARD.md before the agent starts, anchoring the review to your original intent.
3. Launch the Agent: Cards spawns the agent in an isolated Git worktree (.worktrees/cards-<card-id>/), protecting your active branch and uncommitted changes.
4. Review via the Attribution Tree: Inspect the agent's commits in the Attribution Tree, mapping every changed line back to the specific plan, prompt, and model version before merging.

Key Features

🔒 Local-First & Private

Cards does not run a cloud database or upload your source code. Your card history, transcripts, and repositories remain entirely on your local machine.

🌳 Isolated Git Worktrees

Run agents in parallel or switch branches in your main window without interruption. Cards executes the agent inside a dedicated worktree and records its progress on a card-specific branch.

🔍 SCM Attribution Tree

Traditional git blame is broken by agent commits. Cards projects the agent's commits as an Attribution Tree in the Source Control view, showing the net effect of the agent's commits against your live codebase. (Note: Cards does not modify or interfere with the built-in Git source control view.)

⚡ Zero Workspace Pollution

Cards operates out-of-the-box on any local Git repository. It does not modify your project files, install heavy local daemons, or inject global configurations.

Getting Started

1. Installation

Install the extension from the Marketplace or Open VSX Registry:

1. Open the Extensions view (Ctrl+Shift+X or Cmd+Shift+X).
2. Search for Cards (published by goodfoot).
3. Click Install.

2. Link your Agent CLI

Cards coordinates the agent but does not package the model or runner. Link it to your local agent installation:

1. Open the Command Palette (Ctrl+Shift+P or Cmd+Shift+P).
2. Run the command: Cards: Configure Coding Agent (cards.configureAgent).
3. Select your agent (e.g., claude-code-cli or codex-cli).
4. Specify the path to your agent executable if prompted.

3. Run your First Card

1. Click the Cards icon in the Activity Bar to open the Cards panel.
2. Click New Card (or run Cards: New Card from the Command Palette).
3. Describe your task in the opened CARD.md file and save it.
4. Click Launch in the Cards panel.
5. Watch the transcript stream in real time. Once the agent finishes, review the changes in the Attribution Tree and merge them when ready.

Platform Compatibility

Compatible with all major editor forks:

• VS Code
• Cursor
• Windsurf
• VSCodium

Also available on the Open VSX Registry for privacy-focused distributions.

Support & Resources

• Bug Reports & Feature Requests: GitHub Issues
• Discussions & Community: GitHub Discussions
• Official Website: cards.management

License

Proprietary software. Copyright © 2026 Goodfoot Media LLC. See LICENSE for complete terms.