https://github.com/furkankoykiran/contextify-cli
Open-source CLI for Claude Code: capture sessions, ship transcripts to your memory pipeline, and synthesize Claude-ready prompts. TypeScript, Node 20+, MIT.
https://github.com/furkankoykiran/contextify-cli
agent agentic-ai ai ai-agents anthropic claude claude-cli claude-code cli context-engineering contextify developer-tools llm memory nodejs prompt prompt-engineering telemetry transcript typescript
Last synced: 12 days ago
JSON representation
Open-source CLI for Claude Code: capture sessions, ship transcripts to your memory pipeline, and synthesize Claude-ready prompts. TypeScript, Node 20+, MIT.
- Host: GitHub
- URL: https://github.com/furkankoykiran/contextify-cli
- Owner: furkankoykiran
- License: mit
- Created: 2026-05-17T14:51:45.000Z (27 days ago)
- Default Branch: main
- Last Pushed: 2026-05-17T16:51:15.000Z (27 days ago)
- Last Synced: 2026-05-17T18:36:11.677Z (27 days ago)
- Topics: agent, agentic-ai, ai, ai-agents, anthropic, claude, claude-cli, claude-code, cli, context-engineering, contextify, developer-tools, llm, memory, nodejs, prompt, prompt-engineering, telemetry, transcript, typescript
- Language: TypeScript
- Homepage: https://contextify.live
- Size: 309 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# Contextify CLI
> **Open-source CLI for Claude Code: capture sessions, ship transcripts to your memory pipeline, and synthesize Claude-ready prompts.**
[](https://www.npmjs.com/package/@furkankoykiran/contextify-cli)
[](https://www.npmjs.com/package/@furkankoykiran/contextify-cli)
[](https://github.com/furkankoykiran/contextify-cli/actions/workflows/ci.yml)
[](LICENSE)
[](.nvmrc)
`contextify` is the capture half of [Contextify](https://contextify.live) — a closed-loop prompt factory and project memory for Claude Code. It hooks into [Anthropic Claude Code](https://docs.anthropic.com/en/docs/claude-code) sessions on your machine, ships transcripts to your memory pipeline, and turns drafts into Claude-ready prompts grounded in everything your project has already learned.
The CLI is **MIT-licensed and contribution-friendly**. The backend (web app, worker, prompt synthesizer) is closed-source.
## Why use this
- **Claude Code transcript capture** — every `SessionStart`, `Stop`, and `SessionEnd` event is shadowed and streamed without disrupting your flow.
- **Project memory grounding** — turn a one-line draft into a multi-section, memory-augmented Claude Code prompt with `contextify prompt`.
- **Zero per-project config** — `project_id` is derived from each session's `cwd` at fire-time. Install once, capture everywhere.
- **Bring your own server** — point `CONTEXTIFY_SERVER_URL` at `https://contextify.live` or self-host the backend.
## Install
```bash
pnpm add -g @furkankoykiran/contextify-cli
# or
npm i -g @furkankoykiran/contextify-cli
```
## Quick start
1. Create an API key at [https://contextify.live/dashboard/keys](https://contextify.live/dashboard/keys).
2. Export the key and the server URL:
```bash
export CONTEXTIFY_API_KEY="ctx_live_..."
export CONTEXTIFY_SERVER_URL="https://contextify.live"
```
3. Install the Claude Code hooks (once per machine):
```bash
contextify install
```
That's it — every Claude Code session is now captured. Inspect captures and synthesized memories at [https://contextify.live/dashboard](https://contextify.live/dashboard).
## Commands
| Command | What it does |
| ------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------- |
| `contextify install [--key ] [--server ] [--dry-run]` | Wires SessionStart / Stop / SessionEnd into `~/.claude/settings.json`. Run once per machine. |
| `contextify init [projectId] [--name ] [--server ]` | Pin a project id by writing `.contextify.json` in the current directory. |
| `contextify wrap -- [args...]` | Run any command, mirror its output, and ship the capture in batches. |
| `contextify login --key ` | Persist a key to `~/.contextify/credentials.json` (chmod 600). |
| `contextify ship --once` | Flush locally-spooled batches left over from offline runs. |
| `contextify prompt [--top-k N] [--show-memories] [--json]` | Build an XML prompt augmented with project memories. Pass `-` to read from stdin. |
| `contextify hooks ` | Internal — invoked by Claude Code hook scripts. |
| `contextify --version` | Print the CLI version. |
## Environment
| Variable | Purpose |
| ----------------------- | ------------------------------------------------------------------------------------------ |
| `CONTEXTIFY_API_KEY` | Bearer key used to authenticate every request. Wins over `~/.contextify/credentials.json`. |
| `CONTEXTIFY_SERVER_URL` | Target server. Defaults to `https://contextify.live`. |
| `CONTEXTIFY_PROJECT_ID` | Override the auto-derived project id. |
| `CONTEXTIFY_STATE_DIR` | Override the `~/.contextify` state directory. |
| `CLAUDE_SETTINGS_PATH` | Override the `~/.claude/settings.json` path (useful for tests). |
## How project identity is resolved
Project id resolution stack, first match wins:
1. `CONTEXTIFY_PROJECT_ID` (env)
2. `.contextify.json` in the current dir or an ancestor (`projectId` field)
3. Git remote URL of the enclosing repo
4. `realpath` of the current directory
## Development
```bash
git clone https://github.com/furkankoykiran/contextify-cli.git
cd contextify-cli
pnpm install
pnpm build
pnpm test
```
See [CONTRIBUTING.md](CONTRIBUTING.md) for the full workflow.
## Related
- [Contextify](https://contextify.live) — the hosted prompt factory + project memory.
- [Anthropic Claude Code](https://docs.anthropic.com/en/docs/claude-code) — the official CLI this tool hooks into.
## License
[MIT](LICENSE) © Furkan Köykıran