prjct

Context layer for AI coding agents.

Works with Claude Code, Gemini CLI, Antigravity, Cursor IDE, and more.

![Gemini CLI]()
![Antigravity]()
![Cursor IDE]()

What is prjct?

prjct gives AI coding agents the context they need about your project. It maintains state between sessions, tracks progress, and ensures agents understand your codebase.

``
Your AI Agent prjct
(Claude/Gemini/Antigravity/Cursor) │
│ │
│ "What am I working on?" │
│ ────────────────────────────────► │
│ │ Reads project context
│ Task: "Add user auth" │
│ Branch: feature/auth │
│ Subtask 2/5: API routes │
│ ◄──────────────────────────────── │
│ │
▼ │
Writes code with full context │
`

Install

`bash
npm install -g prjct-cli
`

Quick Start

$3

`bash


1. One-time global setup

prjct start

2. Initialize your project

cd my-project
prjct init

3. Open in Claude Code or Gemini CLI and use:

p. sync # Analyze project
p. task "add user auth" # Start a task
p. done # Complete subtask
p. ship # Ship with PR
`

$3

`bash


1. One-time global setup (installs prjct as a skill)

prjct start

2. Initialize your project

cd my-project
prjct init

3. Open in Antigravity and use:

p. sync # Analyze project
p. task "add user auth" # Start a task
p. done # Complete subtask
p. ship # Ship with PR
`

> Note: prjct integrates as a Skill (not MCP server) for zero-overhead operation.

$3

`bash


1. Initialize your project (no global setup needed)

cd my-project
prjct init

2. Open in Cursor and use:

/sync # Analyze project
/task "add user auth" # Start a task
/done # Complete subtask
/ship # Ship with PR
`

> Note: Cursor uses /command syntax. Commands are installed per-project in .cursor/commands/. If deleted, run /sync to regenerate.

$3

`
Claude/Gemini/Antigravity: p. sync → p. task "..." → [code] → p. done → p. ship
Cursor: /sync → /task "..." → [code] → /done → /ship
`

How It Works

| Component | Claude Code | Gemini CLI | Antigravity | Cursor IDE |
|-----------|-------------|------------|-------------|------------|
| Router | ~/.claude/commands/p.md | ~/.gemini/commands/p.toml | Skill | .cursor/commands/*.md |
| Config | ~/.claude/CLAUDE.md | ~/.gemini/GEMINI.md | ~/.gemini/antigravity/skills/prjct/ | .cursor/rules/prjct.mdc |
| Storage | ~/.prjct-cli/projects/ | ~/.prjct-cli/projects/ | ~/.prjct-cli/projects/ | ~/.prjct-cli/projects/ |
| Scope | Global | Global | Global | Per-project |
| Syntax | p. command | p. command | p. command | /command |

All agents share the same project storage, so you can switch between them freely.

Commands

| Claude/Gemini | Cursor | Description |
|---------------|--------|-------------|
| p. sync | /sync | Analyze project, generate domain agents |
| p. task "desc" | /task "desc" | Start task with auto-classification |
| p. done | /done | Complete current subtask |
| p. ship "name" | /ship "name" | Ship feature with PR + version bump |
| p. pause | /pause | Pause current task |
| p. resume | /resume | Resume paused task |
| p. bug "desc" | /bug "desc" | Report a bug |
| p. linear | - | Linear integration |
| p. github | - | GitHub Issues integration |

CLI Commands

`bash
prjct start # First-time setup (Claude/Gemini)
prjct init # Initialize project (+ Cursor setup)
prjct --version # Show version + provider status
prjct --help # Show help
`

Environment Variables

$3

| Variable | Default | Description |
|----------|---------|-------------|
| PRJCT_CLI_HOME | ~/.prjct-cli | Override global storage location. Useful for tests or sandboxed environments. |
| PRJCT_DEBUG | _(unset)_ | Enable debug logging. Values: 1, true, or a log level (error, warn, info, debug). |
| DEBUG | _(unset)_ | Fallback debug flag (used if PRJCT_DEBUG is not set). Values: 1, true, or prjct. |
| CI | _(unset)_ | Set automatically in CI environments. Skips interactive prompts. |

$3

| Variable | Default | Description |
|----------|---------|-------------|
| JIRA_BASE_URL | _(none)_ | JIRA instance URL (e.g., https://myorg.atlassian.net). |
| JIRA_EMAIL | _(none)_ | Email for JIRA API authentication. |
| JIRA_API_TOKEN | _(none)_ | API token for JIRA authentication. Generate at Atlassian API tokens. |

$3

These are typically set by the AI agent runtime, not by users:

| Variable | Description |
|----------|-------------|
| CLAUDE_AGENT | Set when running inside Claude Code. |
| ANTHROPIC_CLAUDE | Alternative Claude environment indicator. |
| MCP_AVAILABLE | Set when MCP (Model Context Protocol) is available. |
| HOME / USERPROFILE | Standard OS home directory (used for path resolution). |

$3

`bash


Enable debug logging

PRJCT_DEBUG=1 prjct sync

Use a custom storage location

PRJCT_CLI_HOME=/tmp/prjct-test prjct init

Configure JIRA integration via env vars

export JIRA_BASE_URL=https://myorg.atlassian.net
export JIRA_EMAIL=you@example.com
export JIRA_API_TOKEN=your-api-token
prjct jira setup
``

Requirements

- Node.js 18+ or Bun 1.0+
- One of: Claude Code, Gemini CLI, Antigravity, or Cursor IDE

Links

- Website
- GitHub
- npm

License

MIT