Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@quantpartners/pca) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

    ◆
   / \
  ◆───◆

PCA — Git for AI context

Quick Start · What is PCA? · Commands · How it works · Git Sync · License

PCA — Git for AI context

PCA is a local-first CLI that keeps project context, decisions, and AI handoff notes close to your code. It solves context drift between Git changes and AI agents.

Builders using AI agents (Cursor, Claude, Codex, Gemini) lose project context between sessions. You repeat yourself. The agent forgets decisions. Prompts grow. PCA fixes that.

Install

npm install -g @quantpartners/pca

Requires Node.js >= 20.

Quick start

cd your-project
pca setup
pca init
pca bootstrap
pca context

pca setup configures mode and API key. pca init initializes project memory. pca bootstrap fills project context interactively. pca context generates the current project context, copies it to your clipboard, and saves .pca/last-context.md.

Commands

CORE

Command	Description
`pca init`	Initialize project memory
`pca bootstrap`	Fill project context interactively
`pca context`	Generate project context and copy to clipboard
`pca commit "<msg>"`	Record a context milestone
`pca staged`	Manage staged context commits
`pca logs`	List context history
`pca status`	Show project and context state

GIT SYNC (automatic)

Hooks run automatically on git commit, checkout, merge and rebase. No manual commands needed.

MAINTENANCE

Command	Description
`pca health`	Check context file sizes
`pca doctor`	Diagnose PCA setup
`pca forget`	Deprecate obsolete context
`pca diff`	Show context diff
`pca audit`	Audit context history
`pca recovery`	Restore a deprecated context commit
`pca sync`	Sync context to vector store
`pca query "<query>"`	Query project memory
`pca task "<task>"`	Generate agent-ready task context
`pca setup`	Configure mode and API key
`pca mcp`	Start MCP server

AUTH

Command	Description
`pca login`	Sign in
`pca logout`	Sign out
`pca whoami`	Show active account
`pca config`	Manage configuration

How it works

Markdown files hold project memory and agent-facing context.
SQLite in .pca/pca.db stores context commits, staged items, branches, and status.
Git hooks stage context from commits and track branch, merge, and rebase events.
pca context builds a paste-ready Markdown snapshot for your AI agent.

Git sync

pca init installs hooks for commit, checkout, merge, and rewrite/rebase events. The hooks stage context automatically, switch branch-local context, and archive old branch context when confirmed. Use pca staged list, pca staged commit, pca staged drop <index>, or pca staged clear to manage staged context.

License

MIT