{"id":50501549,"url":"https://github.com/furkankoykiran/contextify-cli","last_synced_at":"2026-06-02T12:01:40.143Z","repository":{"id":358495478,"uuid":"1241566321","full_name":"furkankoykiran/contextify-cli","owner":"furkankoykiran","description":"Open-source CLI for Claude Code: capture sessions, ship transcripts to your memory pipeline, and synthesize Claude-ready prompts. TypeScript, Node 20+, MIT.","archived":false,"fork":false,"pushed_at":"2026-05-17T16:51:15.000Z","size":316,"stargazers_count":0,"open_issues_count":6,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-17T18:36:11.677Z","etag":null,"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"],"latest_commit_sha":null,"homepage":"https://contextify.live","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/furkankoykiran.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-17T14:51:45.000Z","updated_at":"2026-05-17T16:48:43.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/furkankoykiran/contextify-cli","commit_stats":null,"previous_names":["furkankoykiran/contextify-cli"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/furkankoykiran/contextify-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/furkankoykiran%2Fcontextify-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/furkankoykiran%2Fcontextify-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/furkankoykiran%2Fcontextify-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/furkankoykiran%2Fcontextify-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/furkankoykiran","download_url":"https://codeload.github.com/furkankoykiran/contextify-cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/furkankoykiran%2Fcontextify-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33820643,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-02T02:00:07.132Z","response_time":109,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["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"],"created_at":"2026-06-02T12:01:39.040Z","updated_at":"2026-06-02T12:01:40.119Z","avatar_url":"https://github.com/furkankoykiran.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Contextify CLI\n\n\u003e **Open-source CLI for Claude Code: capture sessions, ship transcripts to your memory pipeline, and synthesize Claude-ready prompts.**\n\n[![npm version](https://img.shields.io/npm/v/@furkankoykiran/contextify-cli.svg)](https://www.npmjs.com/package/@furkankoykiran/contextify-cli)\n[![npm downloads](https://img.shields.io/npm/dm/@furkankoykiran/contextify-cli.svg)](https://www.npmjs.com/package/@furkankoykiran/contextify-cli)\n[![CI](https://github.com/furkankoykiran/contextify-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/furkankoykiran/contextify-cli/actions/workflows/ci.yml)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![Node ≥ 20](https://img.shields.io/badge/node-%E2%89%A520.19-brightgreen.svg)](.nvmrc)\n\n`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.\n\nThe CLI is **MIT-licensed and contribution-friendly**. The backend (web app, worker, prompt synthesizer) is closed-source.\n\n## Why use this\n\n- **Claude Code transcript capture** — every `SessionStart`, `Stop`, and `SessionEnd` event is shadowed and streamed without disrupting your flow.\n- **Project memory grounding** — turn a one-line draft into a multi-section, memory-augmented Claude Code prompt with `contextify prompt`.\n- **Zero per-project config** — `project_id` is derived from each session's `cwd` at fire-time. Install once, capture everywhere.\n- **Bring your own server** — point `CONTEXTIFY_SERVER_URL` at `https://contextify.live` or self-host the backend.\n\n## Install\n\n```bash\npnpm add -g @furkankoykiran/contextify-cli\n# or\nnpm i -g @furkankoykiran/contextify-cli\n```\n\n## Quick start\n\n1. Create an API key at [https://contextify.live/dashboard/keys](https://contextify.live/dashboard/keys).\n2. Export the key and the server URL:\n   ```bash\n   export CONTEXTIFY_API_KEY=\"ctx_live_...\"\n   export CONTEXTIFY_SERVER_URL=\"https://contextify.live\"\n   ```\n3. Install the Claude Code hooks (once per machine):\n   ```bash\n   contextify install\n   ```\n\nThat's it — every Claude Code session is now captured. Inspect captures and synthesized memories at [https://contextify.live/dashboard](https://contextify.live/dashboard).\n\n## Commands\n\n| Command                                                                  | What it does                                                                                 |\n| ------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------- |\n| `contextify install [--key \u003cctx_live_...\u003e] [--server \u003curl\u003e] [--dry-run]` | Wires SessionStart / Stop / SessionEnd into `~/.claude/settings.json`. Run once per machine. |\n| `contextify init [projectId] [--name \u003cname\u003e] [--server \u003curl\u003e]`           | Pin a project id by writing `.contextify.json` in the current directory.                     |\n| `contextify wrap -- \u003ccmd\u003e [args...]`                                     | Run any command, mirror its output, and ship the capture in batches.                         |\n| `contextify login --key \u003cctx_live_...\u003e`                                  | Persist a key to `~/.contextify/credentials.json` (chmod 600).                               |\n| `contextify ship --once`                                                 | Flush locally-spooled batches left over from offline runs.                                   |\n| `contextify prompt \u003cdraft\\|-\u003e [--top-k N] [--show-memories] [--json]`    | Build an XML prompt augmented with project memories. Pass `-` to read from stdin.            |\n| `contextify hooks \u003csession-start\\|stop\\|session-end\u003e`                    | Internal — invoked by Claude Code hook scripts.                                              |\n| `contextify --version`                                                   | Print the CLI version.                                                                       |\n\n## Environment\n\n| Variable                | Purpose                                                                                    |\n| ----------------------- | ------------------------------------------------------------------------------------------ |\n| `CONTEXTIFY_API_KEY`    | Bearer key used to authenticate every request. Wins over `~/.contextify/credentials.json`. |\n| `CONTEXTIFY_SERVER_URL` | Target server. Defaults to `https://contextify.live`.                                      |\n| `CONTEXTIFY_PROJECT_ID` | Override the auto-derived project id.                                                      |\n| `CONTEXTIFY_STATE_DIR`  | Override the `~/.contextify` state directory.                                              |\n| `CLAUDE_SETTINGS_PATH`  | Override the `~/.claude/settings.json` path (useful for tests).                            |\n\n## How project identity is resolved\n\nProject id resolution stack, first match wins:\n\n1. `CONTEXTIFY_PROJECT_ID` (env)\n2. `.contextify.json` in the current dir or an ancestor (`projectId` field)\n3. Git remote URL of the enclosing repo\n4. `realpath` of the current directory\n\n## Development\n\n```bash\ngit clone https://github.com/furkankoykiran/contextify-cli.git\ncd contextify-cli\npnpm install\npnpm build\npnpm test\n```\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for the full workflow.\n\n## Related\n\n- [Contextify](https://contextify.live) — the hosted prompt factory + project memory.\n- [Anthropic Claude Code](https://docs.anthropic.com/en/docs/claude-code) — the official CLI this tool hooks into.\n\n## License\n\n[MIT](LICENSE) © Furkan Köykıran\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffurkankoykiran%2Fcontextify-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffurkankoykiran%2Fcontextify-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffurkankoykiran%2Fcontextify-cli/lists"}