docs / cli-reference
CLI Reference
Full command reference for the PromptConduit CLI: onboarding, hook install,
local cost and Session Graph, skill generation, transcript sync, and
configuration. Every command supports --help.
Global Flags
| Flag | Description |
|---|
--help | Show help for any command |
--version | Print version |
Commands
promptconduit init- Interactive setup: sign in (or stay local-only), detect installed AI tools, and install their hooks.
promptconduit login- Sign in through the browser and save your API key to config.
promptconduit install <tool>- Install hooks for an AI tool. Supported: claude-code, cursor, gemini-cli, codex, copilot, grok. Pass several names, or all.
promptconduit uninstall <tool>- Remove PromptConduit hooks from a tool config.
promptconduit status- Show installation status for all supported tools.
promptconduit test- Test API connectivity and authentication.
promptconduit cost- Local session cost by model and cache hit — nothing leaves the machine.
promptconduit graph- Live Session Graph in the browser, reading ~/.promptconduit/events.jsonl. 100% local.
promptconduit sessions- List recent AI sessions the CLI can reconstruct and reopen.
promptconduit resume [session-id]- Reopen a captured session in its original working directory.
promptconduit watch- Tail outbound HTTP to the platform in real time (hook sends, sync, skills).
promptconduit skills generate --local [flags]- Generate skills from local transcripts without a platform account.
promptconduit skills generate [flags]- Generate skills via platform (requires account).
promptconduit sync [tool] [flags]- Manually upload historical transcripts to the platform.
promptconduit upgrade- Download and apply the latest GitHub release. Also runs in the background once a day.
promptconduit feedback [message]- Send a note to the team. No session data is included.
promptconduit prune- Trim local hook history past the configured retention window.
promptconduit config set [flags]- Set configuration values (--api-key, --api-url, --debug, --local-only).
promptconduit config show- Display current configuration.
promptconduit config env add <name>- Create a named environment.
promptconduit config env use <name>- Switch to a named environment.
promptconduit config env list- List all configured environments.
promptconduit version- Print version information.
Sync Flags
| Flag | Description |
|---|
--dry-run | Preview what would be uploaded without uploading |
--force | Re-upload already synced transcripts |
--since YYYY-MM-DD | Only sync transcripts newer than this date |
--limit N | Sync only the N most recent transcripts |
Local Skills Flags
| Flag | Description |
|---|
--tool <name> | Analyze only a specific tool (e.g. claude-code) |
--repo owner/repo | Scope generated skills to a specific repository |
--force | Re-analyze previously seen transcripts |
--dry-run | Preview detected skills without writing files |