{"id":51628152,"url":"https://github.com/ghulammuzz/clauzz-cli","last_synced_at":"2026-07-15T05:01:08.130Z","repository":{"id":370677895,"uuid":"1296044265","full_name":"ghulammuzz/clauzz-cli","owner":"ghulammuzz","description":"Workspace context manager for AI coding agents: name your Claude Code sessions, resume them in one keypress, and carry context across sessions","archived":false,"fork":false,"pushed_at":"2026-07-13T17:59:52.000Z","size":2433,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-07-14T04:32:09.154Z","etag":null,"topics":["ai-agents","claude-code","cli","context-management","developer-tools","golang","productivity","tui"],"latest_commit_sha":null,"homepage":null,"language":"Go","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/ghulammuzz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"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-07-10T04:24:34.000Z","updated_at":"2026-07-13T18:00:06.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/ghulammuzz/clauzz-cli","commit_stats":null,"previous_names":["ghulammuzz/clauzz-cli"],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/ghulammuzz/clauzz-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ghulammuzz%2Fclauzz-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ghulammuzz%2Fclauzz-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ghulammuzz%2Fclauzz-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ghulammuzz%2Fclauzz-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ghulammuzz","download_url":"https://codeload.github.com/ghulammuzz/clauzz-cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ghulammuzz%2Fclauzz-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35491351,"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-07-15T02:00:06.706Z","response_time":131,"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":["ai-agents","claude-code","cli","context-management","developer-tools","golang","productivity","tui"],"created_at":"2026-07-13T03:30:56.797Z","updated_at":"2026-07-15T05:01:08.061Z","avatar_url":"https://github.com/ghulammuzz.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# clauzz\n\n![clauzz banner](assets/banner.png)\n\n[![Release](https://img.shields.io/github/v/release/ghulammuzz/clauzz-cli)](https://github.com/ghulammuzz/clauzz-cli/releases/latest)\n[![CI](https://github.com/ghulammuzz/clauzz-cli/actions/workflows/release.yml/badge.svg)](https://github.com/ghulammuzz/clauzz-cli/actions)\n[![Go Report Card](https://goreportcard.com/badge/github.com/ghulammuzz/clauzz-cli)](https://goreportcard.com/report/github.com/ghulammuzz/clauzz-cli)\n[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)\n\n**Workspace context manager for AI coding agents.**\n\n## Why\n\nclauzz was born from a very normal week at work: a bunch of microservices, and a separate Claude Code session for each fire.\nOne session chasing a Kafka DLQ, one debugging a payment webhook that double-charges, one staring at replica lag.\n\nThen Monday comes, you run `claude -r`, and it's a wall of UUIDs.\nWhich one was the webhook fix? No idea. You open three wrong sessions before you find it.\n\nclauzz fixes that loop:\n\n- **Name your sessions**: `Task Kafka DLQ` instead of `3f2a8c1e-...`.\n- **Resume in one keypress**: a picker grouped by directory; enter drops you back in via `claude --resume`, in the right project.\n- **Search everything**: \"which session talked about idempotency keys?\" answered from every transcript on your machine.\n- **Move context between sessions**: the DLQ session knows things your new session needs? `/clauzz:context` hands them over.\n- **All without leaving Claude Code**: register, list, and pull context via slash commands.\n\nClaude Code today; adapters for other agents are on the roadmap.\n\n![clauzz demo](demo/demo.gif)\n\n## Install\n\nLinux / macOS:\n\n```sh\ncurl -sSL https://clauzz.muzz-ai.com/install.sh | sh\n```\n\nThe script grabs the latest release for your platform, checks the sha256, installs the binary, and drops in the Claude Code slash commands.\nWindows is not supported (resume uses `exec(2)`).\n\n\u003cdetails\u003e\n\u003csummary\u003eOther install methods\u003c/summary\u003e\n\nWith Go installed:\n\n```sh\ngo install github.com/ghulammuzz/clauzz-cli/cmd/clauzz@latest\n```\n\nBuild from source:\n\n```sh\ngo build -o clauzz ./cmd/clauzz \u0026\u0026 mv clauzz /usr/local/bin/\n```\n\nSlash commands only (if you skipped the install script):\n\n```sh\nmkdir -p ~/.claude/commands/clauzz \u0026\u0026 cp claude-command/*.md ~/.claude/commands/clauzz/\n```\n\n\u003c/details\u003e\n\n## Usage\n\n### CLI\n\n| Command | What it does |\n|---------|--------------|\n| `clauzz` | Interactive picker; enter resumes the session via `claude --resume` in its directory |\n| `clauzz add {name}` | Register the current Claude session under a custom name |\n| `clauzz list` | List registered sessions grouped by directory (`ls` works too) |\n| `clauzz search {query}` | Full-text search across every session on the machine |\n| `clauzz context {id-prefix} [focus...]` | Print the context digest of a session (powers `/clauzz:context`) |\n| `clauzz rename {id-prefix} {new-name}` | Rename a registered session |\n| `clauzz rm {id-prefix}` | Remove a session from the registry (`delete` works too) |\n| `clauzz prune` | Drop all `[gone]` entries whose transcript was deleted |\n\nSession ID prefixes need at least 4 characters.\n\n### Slash commands (inside Claude Code)\n\n| Command | What it does |\n|---------|--------------|\n| `/clauzz:add-session {name}` | Register the current session under a custom name |\n| `/clauzz:list` | Show registered sessions |\n| `/clauzz:context {id-prefix} [focus query]` | Load another session's context into this one |\n\nExample:\n\n```\n$ clauzz ls\n/Users/demo/code/shop-api\n  Task Kafka DLQ                 3f2a8c1e   2026-07-10 16:15\n  Fix payment webhook            8b91d4f7   2026-07-09 21:00\n/Users/demo/code/shop-web\n  Checkout revamp                e15fb3c8   2026-07-10 23:45\n\n$ clauzz rm 8b91\nremoved \"Fix payment webhook\" (8b91d4f7) in /Users/demo/code/shop-api\n```\n\n## Demos\n\n### Register a session from Claude Code\n\nWorking on something worth coming back to? Name it before you forget:\n\n1. In your session, type `/clauzz:add-session {name}`, e.g. `/clauzz:add-session Demo Session`.\n2. Claude confirms: `Session \"Demo Session\" registered -\u003e 84409ceb in ...`.\n3. From now on it shows up in `clauzz ls` and the picker under that name.\n\nRe-running `/clauzz:add-session` in the same session just renames it.\n\n![clauzz add-session demo](demo/add-session.gif)\n\n### Search across every session\n\n\"Which session talked about kafka?\" `clauzz search` answers from every transcript on the machine, registered in clauzz or not.\n\n![clauzz search demo](demo/search.gif)\n\n### Pull context from another session\n\nYou are in a fresh session, but the decisions you need live in last week's DLQ session.\nType `/clauzz:context {id-prefix} [what you want from it]` and Claude loads a digest of that session, greps its transcript for your focus topic, and reports back:\n\n![clauzz context demo](demo/context.gif)\n\n## How it works\n\n- The registry is a single JSON file at `~/.clauzz/sessions.json`; removing an entry never touches the Claude session itself.\n- `add` resolves the current session from `$CLAUDE_SESSION_ID`, falling back to the newest transcript in `~/.claude/projects/{encoded-cwd}/`.\n- Entries whose transcript was deleted show `[gone]` and cannot be resumed; clean them up with `clauzz rm` or `clauzz prune`.\n- The context digest carries the source session's title, every user prompt, and the last 20 messages (truncated).\n  With a focus query, Claude also greps the source transcript for that topic and loads only the relevant parts.\n\n### Context transfer flow\n\nHow `/clauzz:context` moves context from session B into the active session A:\n\n```mermaid\nsequenceDiagram\n    actor User\n    participant A as Claude session A\n    participant CLI as clauzz CLI\n    participant Reg as ~/.clauzz/sessions.json\n    participant B as Session B transcript (jsonl)\n\n    User-\u003e\u003eA: /clauzz:context {id-prefix-B}\n    A-\u003e\u003eCLI: clauzz context {id-prefix-B}\n    CLI-\u003e\u003eReg: resolve prefix to session B entry\n    CLI-\u003e\u003eB: parse transcript\n    Note over CLI,B: keep user prompts + assistant text,\u003cbr/\u003edrop tool calls, results, thinking, sidechains\n    CLI--\u003e\u003eA: digest (title, all user prompts,\u003cbr/\u003elast 20 messages, transcript path)\n    Note over A: digest becomes part of\u003cbr/\u003esession A's context\n\n    opt focus query given, or digest not enough\n        A-\u003e\u003eB: Read/Grep specific parts of the transcript\n        B--\u003e\u003eA: only the details needed\n    end\n\n    A--\u003e\u003eUser: summary of loaded context,\u003cbr/\u003eready to work with it\n```\n\n## Uninstall\n\n```sh\ncurl -sSL https://clauzz.muzz-ai.com/uninstall.sh | sh\n```\n\nRemoves the binary and the slash commands.\nYour session registry at `~/.clauzz` survives; add `| sh -s -- --purge` if you want it gone too.\n\n## License\n\n[MIT](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fghulammuzz%2Fclauzz-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fghulammuzz%2Fclauzz-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fghulammuzz%2Fclauzz-cli/lists"}