@tryverum/coldstart

Seeds a Verum workspace from the coding-agent history already on your machine — so your brain starts with real decisions instead of empty.

npx @tryverum/coldstart --workspace <uuid> --token <your agent token>

Add --dry-run to see exactly what it would send, without sending anything.

What it does

Reads Claude Code, Cursor and Codex sessions on your machine, finds the ones related to your project, and uploads only short passages that state a decision, a failure, or a convention.

• Runs locally. Transcripts never leave your machine.
• Redacts first. API keys, tokens, passwords, connection strings and .env contents are removed before anything is serialized.
• Sends derived knowledge only. Never whole transcripts, never file paths.
• Provisional by default. Everything learned lands in your review queue. Nothing is treated as established until you confirm it, and you can withdraw all of it in one click.

Options

| Flag | | |---|---| | --workspace <uuid> | Workspace id (or VERUM_WORKSPACE) | | --token <tcb_live_…> | Agent token (or VERUM_TOKEN — preferred, since argv is visible via ps) | | --url <url> | Deployment (or VERUM_URL). Must be https:// unless localhost. | | --repo <path> | Local checkout to match against (default: cwd) | | --keywords a,b,c | Extra matching terms — the standalone path when no repo is connected | | --dry-run | Scan and print what would be sent. Uploads nothing. | | --budget-seconds <n> | Wall-clock ceiling (default: 120) | | --json | Machine-readable output |

Requires Node 20+.