{"_id":"@3notch/cli","_rev":"7-056c4520827f303bc35647f78ab16171","name":"@3notch/cli","dist-tags":{"latest":"0.8.0"},"versions":{"0.4.0":{"name":"@3notch/cli","version":"0.4.0","keywords":["ai","agents","cli","context","handoff","packets","privacy","mcp"],"author":{"name":"3Notch contributors"},"license":"MIT","_id":"@3notch/cli@0.4.0","maintainers":[{"name":"coldlogicai","email":"sean@ipsm.app"}],"homepage":"https://github.com/coldlogicAI/3notch#readme","bugs":{"url":"https://github.com/coldlogicAI/3notch/issues"},"bin":{"notch":"dist/cli/index.js"},"dist":{"shasum":"67df37c16b132a80fd7eeb2d34b118eeb33a9a0b","tarball":"https://registry.npmjs.org/@3notch/cli/-/cli-0.4.0.tgz","fileCount":48,"integrity":"sha512-TjxsBDtGStjvAdOSr/KQED6ufX5EVyg9fchF0Vo/Lb95S0xeKmcVP3HjdiA6GtYTFYfyz5CYJ/FF0zPowGh24w==","signatures":[{"sig":"MEUCIQDpFLrGc+itXXFEjNwP6dPctjBoEwZwYK1V6M1P3cIL1wIgN3O1DnOFsSaCMr4aUVSXhISjAHYlxJfIjFtJdEsfg5M=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":916815},"type":"module","engines":{"node":">=20"},"gitHead":"15048bea7a5d64930320f2fd3b466366434d404f","scripts":{"lint":"eslint .","test":"vitest run","build":"tsup","prepack":"npm run build","test:e2e":"vitest run tests/e2e","test:watch":"vitest","type-check":"tsc --noEmit"},"_npmUser":{"name":"coldlogicai","email":"sean@ipsm.app"},"repository":{"url":"git+https://github.com/coldlogicAI/3notch.git","type":"git"},"_npmVersion":"11.11.0","description":"Local-first private context packets across repos and AI tools.","directories":{},"_nodeVersion":"25.3.0","dependencies":{"ajv":"^8.20.0","yaml":"^2.9.0","commander":"^14.0.3","gray-matter":"^4.0.3","@modelcontextprotocol/sdk":"^1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.22.3","tsup":"^8.5.1","eslint":"^10.4.0","vitest":"^4.1.7","@eslint/js":"^10.0.1","typescript":"^5.9.3","@types/node":"^20.19.41","typescript-eslint":"^8.59.4"},"_npmOperationalInternal":{"tmp":"tmp/cli_0.4.0_1779802822766_0.6271432426935892","host":"s3://npm-registry-packages-npm-production"}},"0.4.1":{"name":"@3notch/cli","version":"0.4.1","keywords":["ai","agents","cli","context","handoff","packets","privacy","mcp"],"author":{"name":"3Notch contributors"},"license":"MIT","_id":"@3notch/cli@0.4.1","maintainers":[{"name":"coldlogicai","email":"sean@ipsm.app"}],"homepage":"https://3notch.dev","bugs":{"url":"https://github.com/coldlogicAI/3notch/issues"},"bin":{"notch":"dist/cli/index.js"},"dist":{"shasum":"4b06bc97204cfb05edeb3139e2d1380d8433252f","tarball":"https://registry.npmjs.org/@3notch/cli/-/cli-0.4.1.tgz","fileCount":48,"integrity":"sha512-zCjkHTwmc0p/KmswFFqf19cDyJOAPvnWdAq5xXAU0oJ4KOUrti2W9relesObQPweLecjYDGxtPgdKz2pFQUW+w==","signatures":[{"sig":"MEUCIAKYstvbM1DpYHhpA1SfgGTAce2sl5u1wxPNmqDMMQmrAiEAuBGg2o7ivY+j/MPLx3qLbkEWPAYhatUz5Wa0x6d5a5Q=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":916993},"type":"module","engines":{"node":">=20"},"gitHead":"f1ee6805b2f2c075f383b45664c5dfcb9b30fbe9","scripts":{"lint":"eslint .","test":"vitest run","build":"tsup","prepack":"npm run build","test:e2e":"vitest run tests/e2e","test:watch":"vitest","type-check":"tsc --noEmit"},"_npmUser":{"name":"coldlogicai","email":"sean@ipsm.app"},"repository":{"url":"git+https://github.com/coldlogicAI/3notch.git","type":"git"},"_npmVersion":"11.11.0","description":"Local-first private context packets across repos and AI tools.","directories":{},"_nodeVersion":"25.3.0","dependencies":{"ajv":"^8.20.0","yaml":"^2.9.0","commander":"^14.0.3","gray-matter":"^4.0.3","@modelcontextprotocol/sdk":"^1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.22.3","tsup":"^8.5.1","eslint":"^10.4.0","vitest":"^4.1.7","@eslint/js":"^10.0.1","typescript":"^5.9.3","@types/node":"^20.19.41","typescript-eslint":"^8.59.4"},"_npmOperationalInternal":{"tmp":"tmp/cli_0.4.1_1779807378299_0.42211438078795416","host":"s3://npm-registry-packages-npm-production"}},"0.5.0":{"name":"@3notch/cli","version":"0.5.0","keywords":["ai","agents","cli","context","handoff","packets","privacy","mcp","session","recovery","working-state","checkpoint"],"author":{"name":"3Notch contributors"},"license":"MIT","_id":"@3notch/cli@0.5.0","maintainers":[{"name":"coldlogicai","email":"sean@ipsm.app"}],"homepage":"https://3notch.dev","bugs":{"url":"https://github.com/coldlogicAI/3notch/issues"},"bin":{"notch":"dist/cli/index.js"},"dist":{"shasum":"e74c3ec779bf87d17e3867f6de800c7fff449cc2","tarball":"https://registry.npmjs.org/@3notch/cli/-/cli-0.5.0.tgz","fileCount":51,"integrity":"sha512-by9rf7Zo88ztlFev1UJcHIfoFJ3BaJAxYMYzTRH4ezzotEbuwPoKgiY1rFTE9lxoXDz/C3kh5QHxL7mD+s8bww==","signatures":[{"sig":"MEQCIB9KD9aEJ8BOjLvwLIuJCIh4KaTidDntgFcNV9yk35w4AiAFhHeONcsmJqr/E9klzvZDfJr9fSMtAp2YR5FA/1D/Eg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1060391},"type":"module","engines":{"node":">=20"},"gitHead":"99ba5738a6dfde2f92c82144d9851945a611596b","scripts":{"lint":"eslint .","test":"vitest run","build":"tsup","prepack":"npm run build","test:e2e":"vitest run tests/e2e","test:watch":"vitest","type-check":"tsc --noEmit"},"_npmUser":{"name":"coldlogicai","email":"sean@ipsm.app"},"repository":{"url":"git+https://github.com/coldlogicAI/3notch.git","type":"git"},"_npmVersion":"10.9.8","description":"Save the working state your AI tools won't. Local checkpoints and portable packets across tools, repos, and machines.","directories":{},"_nodeVersion":"22.22.3","dependencies":{"ajv":"^8.20.0","yaml":"^2.9.0","commander":"^14.0.3","gray-matter":"^4.0.3","@modelcontextprotocol/sdk":"^1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.22.3","tsup":"^8.5.1","eslint":"^10.4.0","vitest":"^4.1.7","@eslint/js":"^10.0.1","typescript":"^5.9.3","@types/node":"^20.19.41","typescript-eslint":"^8.59.4"},"_npmOperationalInternal":{"tmp":"tmp/cli_0.5.0_1784473399820_0.45414730202194753","host":"s3://npm-registry-packages-npm-production"}},"0.7.0":{"name":"@3notch/cli","version":"0.7.0","keywords":["ai","agents","cli","context","handoff","packets","privacy","mcp","session","recovery","working-state","checkpoint"],"author":{"name":"3Notch contributors"},"license":"MIT","_id":"@3notch/cli@0.7.0","maintainers":[{"name":"coldlogicai","email":"sean@ipsm.app"}],"homepage":"https://3notch.dev","bugs":{"url":"https://github.com/coldlogicAI/3notch/issues"},"bin":{"notch":"dist/cli/index.js"},"dist":{"shasum":"fa0167497b9f8a1dfba7fb7ef2bba8dc738184d8","tarball":"https://registry.npmjs.org/@3notch/cli/-/cli-0.7.0.tgz","fileCount":55,"integrity":"sha512-PHDdw3dyTkWxjXwW9eAVrF23WNdtrPbbydrEPQXalWftxFuKTESXFV9QnWOLMvuQEN01Lu1ZFi9ETlq75XdpHA==","signatures":[{"sig":"MEYCIQD4v0wJC5f1usMYE8mb8LPY8djDFHnrNrMW+EGDHXCIfAIhALfipuI6mrTXE8BG75e3Uo3Ch1faxrdGVtQA+VAbw1+c","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1275902},"type":"module","engines":{"node":">=20"},"gitHead":"a987a84d6ac64ba0f338ed7a8c3e3dc5ecbfe777","scripts":{"lint":"eslint .","test":"vitest run","build":"tsup","prepack":"npm run build","test:e2e":"vitest run tests/e2e","test:watch":"vitest","type-check":"tsc --noEmit","release:check":"node scripts/release-check.mjs","release:status":"node scripts/release-check.mjs --with-npm"},"_npmUser":{"name":"coldlogicai","email":"sean@ipsm.app"},"overrides":{"tsup":{"esbuild":"^0.28.1"}},"repository":{"url":"git+https://github.com/coldlogicAI/3notch.git","type":"git"},"_npmVersion":"11.18.0","description":"Save the working state your AI tools won't. Local checkpoints and portable packets across tools, repos, and machines.","directories":{},"_nodeVersion":"26.6.0","dependencies":{"ajv":"^8.20.0","yaml":"^2.9.0","commander":"^14.0.3","gray-matter":"^4.0.3","@modelcontextprotocol/sdk":"^1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.22.3","tsup":"^8.5.1","eslint":"^10.4.0","vitest":"^4.1.7","@eslint/js":"^10.0.1","typescript":"^5.9.3","@types/node":"^20.19.41","typescript-eslint":"^8.59.4"},"_npmOperationalInternal":{"tmp":"tmp/cli_0.7.0_1786291098700_0.771543495396237","host":"s3://npm-registry-packages-npm-production"}},"0.7.1":{"name":"@3notch/cli","version":"0.7.1","keywords":["ai","agents","cli","context","handoff","packets","privacy","mcp","session","recovery","working-state","checkpoint"],"author":{"name":"3Notch contributors"},"license":"MIT","_id":"@3notch/cli@0.7.1","maintainers":[{"name":"coldlogicai","email":"sean@ipsm.app"}],"homepage":"https://3notch.dev","bugs":{"url":"https://github.com/coldlogicAI/3notch/issues"},"bin":{"notch":"dist/cli/index.js"},"dist":{"shasum":"448e84893c29c5abd981cbac3a334854515fdfc9","tarball":"https://registry.npmjs.org/@3notch/cli/-/cli-0.7.1.tgz","fileCount":55,"integrity":"sha512-icx3Ytq1TU/87Tz6B4vO6GlVq3mczsvwej2gkzCfDIyAbl+bG6FhhIFyJAdi7eMJ/iqJRIescUVZ6wGSbdj+6g==","signatures":[{"sig":"MEYCIQDEKdZcW0q0oLeHGVCxKVZ+H7GafH4dT7g+sQZxjA+McgIhAMxWgyPN8JVkZQvW2GbvifsXbZXeeviHI7mUwrSXt/M5","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1285166},"type":"module","engines":{"node":">=20"},"gitHead":"f38b71cf3e9b1d953281122952eb4e5cd31904de","scripts":{"lint":"eslint .","test":"vitest run","build":"tsup","prepack":"npm run build","test:e2e":"vitest run tests/e2e","test:watch":"vitest","type-check":"tsc --noEmit","release:check":"node scripts/release-check.mjs","release:status":"node scripts/release-check.mjs --with-npm"},"_npmUser":{"name":"coldlogicai","email":"sean@ipsm.app"},"overrides":{"tsup":{"esbuild":"^0.28.1"}},"repository":{"url":"git+https://github.com/coldlogicAI/3notch.git","type":"git"},"_npmVersion":"11.18.0","description":"Save the working state your AI tools won't. Local checkpoints and portable packets across tools, repos, and machines.","directories":{},"_nodeVersion":"26.6.0","dependencies":{"ajv":"^8.20.0","yaml":"^2.9.0","commander":"^14.0.3","gray-matter":"^4.0.3","@modelcontextprotocol/sdk":"^1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.22.3","tsup":"^8.5.1","eslint":"^10.4.0","vitest":"^4.1.7","@eslint/js":"^10.0.1","typescript":"^5.9.3","@types/node":"^20.19.41","typescript-eslint":"^8.59.4"},"_npmOperationalInternal":{"tmp":"tmp/cli_0.7.1_1786291993315_0.5945021776092452","host":"s3://npm-registry-packages-npm-production"}},"0.7.2":{"name":"@3notch/cli","version":"0.7.2","keywords":["ai","agents","cli","context","handoff","packets","privacy","mcp","session","recovery","working-state","checkpoint"],"author":{"name":"3Notch contributors"},"license":"MIT","_id":"@3notch/cli@0.7.2","maintainers":[{"name":"coldlogicai","email":"sean@ipsm.app"}],"homepage":"https://3notch.dev","bugs":{"url":"https://github.com/coldlogicAI/3notch/issues"},"bin":{"notch":"dist/cli/index.js"},"dist":{"shasum":"5b715c71998db79ee5a8f5490569c4295350e934","tarball":"https://registry.npmjs.org/@3notch/cli/-/cli-0.7.2.tgz","fileCount":55,"integrity":"sha512-GQ9qVnzSsDZk6JUI9b6dPkDJdP3NLmbLqMUyo+8OfELJsPmIJh4lIzbc7lkhTMI+oyWMHmerBlo89wqEEFDvQQ==","signatures":[{"sig":"MEUCIQD/sSxofv7ew1oX4h2Z/wXAn9qkh8GAZFDOZENMy2RUAQIgK8VtbPnPDfkD7cPeyQ6oexKYPgr++9mx+zyfJedzJxQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1323782},"type":"module","engines":{"node":">=20"},"gitHead":"7c6ec38cd8887837faa50f601d7cb71c0913c961","scripts":{"lint":"eslint .","test":"vitest run","build":"tsup","prepack":"npm run build","test:e2e":"vitest run tests/e2e","test:watch":"vitest","type-check":"tsc --noEmit","release:check":"node scripts/release-check.mjs","release:status":"node scripts/release-check.mjs --with-npm"},"_npmUser":{"name":"coldlogicai","email":"sean@ipsm.app"},"overrides":{"tsup":{"esbuild":"^0.28.1"}},"repository":{"url":"git+https://github.com/coldlogicAI/3notch.git","type":"git"},"_npmVersion":"11.18.0","description":"Save the working state your AI tools won't. Local checkpoints and portable packets across tools, repos, and machines.","directories":{},"_nodeVersion":"26.6.0","dependencies":{"ajv":"^8.20.0","yaml":"^2.9.0","commander":"^14.0.3","gray-matter":"^4.0.3","@modelcontextprotocol/sdk":"^1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.22.3","tsup":"^8.5.1","eslint":"^10.4.0","vitest":"^4.1.7","@eslint/js":"^10.0.1","typescript":"^5.9.3","@types/node":"^20.19.41","typescript-eslint":"^8.59.4"},"_npmOperationalInternal":{"tmp":"tmp/cli_0.7.2_1786457751667_0.29383041427913503","host":"s3://npm-registry-packages-npm-production"}},"0.8.0":{"name":"@3notch/cli","version":"0.8.0","description":"Save the working state your AI tools won't. Local checkpoints and portable packets across tools, repos, and machines.","type":"module","license":"MIT","author":{"name":"3Notch contributors"},"homepage":"https://3notch.dev","repository":{"type":"git","url":"git+https://github.com/coldlogicAI/3notch.git"},"bugs":{"url":"https://github.com/coldlogicAI/3notch/issues"},"keywords":["ai","agents","cli","context","handoff","packets","privacy","mcp","session","recovery","working-state","checkpoint"],"engines":{"node":">=20"},"bin":{"notch":"dist/cli/index.js"},"scripts":{"build":"tsup","lint":"eslint .","prepack":"npm run build","release:check":"node scripts/release-check.mjs","release:status":"node scripts/release-check.mjs --with-npm","test":"vitest run","test:e2e":"vitest run tests/e2e","test:watch":"vitest","type-check":"tsc --noEmit"},"publishConfig":{"access":"public"},"dependencies":{"@modelcontextprotocol/sdk":"^1.29.0","ajv":"^8.20.0","commander":"^14.0.3","gray-matter":"^4.0.3","yaml":"^2.9.0"},"devDependencies":{"@eslint/js":"^10.0.1","@types/node":"^20.19.41","eslint":"^10.4.0","tsup":"^8.5.1","tsx":"^4.22.3","typescript":"^5.9.3","typescript-eslint":"^8.59.4","vitest":"^4.1.7"},"overrides":{"tsup":{"esbuild":"^0.28.1"}},"gitHead":"65f04f543f315b361c862056a56806e6111b5bb4","_id":"@3notch/cli@0.8.0","_nodeVersion":"26.6.0","_npmVersion":"11.18.0","dist":{"integrity":"sha512-czCTUGEOmxts7F26YjFiAIq1TgMKmlGCoqBh4am1nbt9WMpFAxeZ3iShN9mEjC6ie48Q+DJpXx9y/0XykDm92w==","shasum":"90c7dfba24e7f3b4325391409ba0ca24208e9086","tarball":"https://registry.npmjs.org/@3notch/cli/-/cli-0.8.0.tgz","fileCount":55,"unpackedSize":1353936,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIHqSa0m2ECCDdUJknacKkzFpTEZpbdCum1tSP1j6i1Z6AiEAyYL/NG97MZeJ2ZrvUdwSJwJkZZldHfwvxTR89QvCxus="}]},"_npmUser":{"name":"coldlogicai","email":"sean@ipsm.app"},"directories":{},"maintainers":[{"name":"coldlogicai","email":"sean@ipsm.app"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/cli_0.8.0_1788748743164_0.8727631517387324"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-26T13:40:22.609Z","modified":"2026-09-07T02:39:03.505Z","0.4.0":"2026-05-26T13:40:22.995Z","0.4.1":"2026-05-26T14:56:18.546Z","0.5.0":"2026-07-19T15:03:20.005Z","0.7.0":"2026-08-09T15:58:18.864Z","0.7.1":"2026-08-09T16:13:13.476Z","0.7.2":"2026-08-11T14:15:51.804Z","0.8.0":"2026-09-07T02:39:03.301Z"},"bugs":{"url":"https://github.com/coldlogicAI/3notch/issues"},"author":{"name":"3Notch contributors"},"license":"MIT","homepage":"https://3notch.dev","keywords":["ai","agents","cli","context","handoff","packets","privacy","mcp","session","recovery","working-state","checkpoint"],"repository":{"type":"git","url":"git+https://github.com/coldlogicAI/3notch.git"},"description":"Save the working state your AI tools won't. Local checkpoints and portable packets across tools, repos, and machines.","maintainers":[{"name":"coldlogicai","email":"sean@ipsm.app"}],"readme":"# 3Notch\n\n**Save the working state your AI tools won't.**\n\n[Website](https://3notch.dev) · [Docs](https://3notch.dev/docs/) · [Quickstart](https://3notch.dev/docs/quickstart/) · [npm](https://www.npmjs.com/package/@3notch/cli)\n\n[![CI](https://img.shields.io/github/actions/workflow/status/coldlogicAI/3notch/ci.yml?branch=main&style=flat-square)](https://github.com/coldlogicAI/3notch/actions/workflows/ci.yml)\n[![npm](https://img.shields.io/npm/v/@3notch/cli?style=flat-square)](https://www.npmjs.com/package/@3notch/cli)\n[![Node](https://img.shields.io/node/v/@3notch/cli?style=flat-square)](https://nodejs.org)\n[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square)](LICENSE)\n[![3notch MCP server](https://glama.ai/mcp/servers/coldlogicAI/3notch/badges/score.svg)](https://glama.ai/mcp/servers/coldlogicAI/3notch)\n\nA Claude Code session dies mid-run — rate limit, crash, compaction, laptop sleep — or you're moving a task from Claude Code to Codex, Cursor, or ChatGPT. The code is still in git. The objective, decisions, and next steps often are not. The next session rebuilds that state from scratch.\n\n3Notch is a **local CLI and MCP server** for:\n\n- **Continuation checkpoints** — when Claude Code is configured, recover after rate limits, model-down failures, and compaction\n- **Portable packets** — hand off selected work across tools, repos, and machines\n- **Durable inbox** — async delivery between stores that share a mailbox root\n\nNo cloud service. No account. No telemetry. Records stay on disk as Markdown (and optional artifacts) under `.notch/`.\n\n---\n\n## Why this layer exists\n\nEvery major vendor ships transcript persistence and memory files. None ship durable **working state**:\n\n- **Claude Code** auto-saves transcripts and takes file checkpoints — but checkpoints are session-scoped undo, gone when the session ends.\n- **OpenAI's Agents SDK** serializes `RunState` — at planned human-approval pauses, not arbitrary failures.\n- **Gemini and Grok** persist conversations server-side. A transcript is a diary, not a manifest.\n\nRecovering from a transcript means re-reading a conversation and re-interpreting what happened. The vendors' own guidance converges on the fix: combine native persistence with handoff files and checkpoint strategies. 3Notch is that layer — local, vendor-neutral, yours.\n\n---\n\n## Install\n\n```bash\nnpm install -g @3notch/cli\nnotch onboard\n```\n\nAgent prompt (optional):\n\n> Install @3notch/cli, run `notch onboard` in this repo, and set up continuation checkpoints if I use Claude Code. Use packets for handoffs across tools or repos. Read the package README before changing MCP config.\n\n---\n\n## Common flows\n\n### Save and resume working state\n\nWrap-up: `notch save`. Session start: `notch resume`. No confirmation prompt. Codex, Grok, and Cursor should run those two commands; there is no 3Notch daemon.\n\n```bash\nnotch save --summary \"Auth validation done\" --next-steps \"Implement session store\"\nnotch resume\nnotch resume --json\n```\n\nClaude Code SessionStart injects the latest checkpoint body so the next agent can continue without calling `get_packet` after a human yes. Private packets stay hidden unless you pass `--include-private`. See [Continuation checkpoints](docs/guides/continuation-checkpoints.md).\n\n### Hand off between tools\n\n```bash\nnotch packet create \\\n  --title \"Auth refactor checkpoint\" \\\n  --summary \"Token validation done; session store migration blocked.\" \\\n  --next-steps \"Implement Redis session adapter\"\n\nnotch packet preview <id>\n# other tool / session imports and continues\n```\n\n### Ship files to another repo or machine\n\n```bash\nnotch packet create \\\n  --title \"Brand handoff\" \\\n  --summary \"Assets and layout for the launch page.\" \\\n  --file mascot.jpg:asset \\\n  --file showcase.html:source \\\n  --next-steps \"Build the launch page from showcase.html and mascot.jpg.\"\n\nnotch packet pack <id>\n# move <id>.notchpkt however you prefer, then:\nnotch packet unpack <id>.notchpkt\n```\n\n### Async agents — durable inbox\n\nBoth sides register the same mailbox root, then pack/send and pull/ack:\n\n```bash\nnotch inbox init --name review-agent --root /shared/3notch-mailbox\nnotch packet pack <id>\nnotch send <id>.notchpkt --to local:review-agent\n# forward the printed delivery notice via chat, Slack, etc.\n\nnotch inbox list\nnotch inbox pull <delivery-id> --import\nnotch inbox ack <delivery-id>\n```\n\n`local:` addresses are routing labels, not authenticated identity. See [Durable inbox](docs/guides/durable-inbox.md).\n\n### Web chat without MCP\n\n```bash\nnotch prompt --client claude-chat\n# paste into the chat, copy the packet back\npbpaste | notch packet import -\n```\n\n### Personal capture\n\n```bash\nnotch mark --summary \"Keep browser auth cookie-based\" --tags auth\n```\n\n---\n\n## How it works\n\n1. You or an agent write selected context through the CLI or MCP tools.\n2. 3Notch validates, secret-scans, and stores records under `.notch/`.\n3. Preview before another agent relies on the content.\n4. The next session, tool, or store imports or resumes from that record.\n\nTargeting fields (`--to-agent`, `--to-repo`) are intent metadata. Bytes move via your transport (scp, git, AirDrop, Tailscale) or the durable inbox mailbox — not a 3Notch-hosted relay.\n\n---\n\n## Commands\n\n```text\nnotch onboard                         initialize .notch/ and MCP setup\nnotch save                            write a continuation from git snapshot + summary\nnotch resume                          print the latest continuation (no prompt)\nnotch packet create                   create a packet (--file, --ref, --next-steps)\nnotch packet import <path>            import into .notch/inbox/\nnotch packet preview <id>             show what an agent will read\nnotch packet pack / unpack            .notchpkt archive round-trip\nnotch packet list / show              list / inspect packets\nnotch inbox init/list/status/pull/ack durable delivery lifecycle\nnotch send <archive> --to <address>   send a packed project handoff\nnotch reply <id>                      typed reply to a packet\nnotch mark                            self-addressed private capture\nnotch brief / brief create|list|show  scoped task briefs\nnotch seed from <path>                private context seeding\nnotch prompt --client <client>        agent / web-chat instruction packs\nnotch scan <file-or-stdin>            secret scanner\nnotch check                           structural corpus checks\nnotch doctor                          store diagnostics\nnotch status                          store summary\nnotch mcp serve                        local stdio MCP server\n```\n\n---\n\n## MCP\n\n`notch mcp serve` over local stdio:\n\n| | Tools |\n| --- | --- |\n| **Read** | `get_brief`, `list_briefs`, `get_targeted_brief`, `get_packet`, `list_packets`, `resume_working_state`, `list_inbox`, `get_inbox_delivery`, `get_status`, `check_store`, `run_doctor` |\n| **Write** | `create_brief`, `create_packet`, `save_working_state`, `create_mark`, `create_reply`, `create_seed_packet`, `import_packet`, `import_seed_packet`, `inbox_init`, `send_packet`, `pull_inbox_packet`, `ack_inbox_delivery` |\n\nPrivate records under `.notch/private/` stay hidden unless the server starts with `--include-private`. Client setup: [docs/guides/mcp-setup.md](docs/guides/mcp-setup.md).\n\n---\n\n## Documentation\n\n| Topic | Guide |\n| --- | --- |\n| Index | [docs/README.md](docs/README.md) |\n| Cross-repo packets | [docs/guides/cross-repo-packets.md](docs/guides/cross-repo-packets.md) |\n| Cross-tool handoff | [docs/guides/cross-tool-handoff.md](docs/guides/cross-tool-handoff.md) |\n| Durable inbox | [docs/guides/durable-inbox.md](docs/guides/durable-inbox.md) |\n| Continuation checkpoints | [docs/guides/continuation-checkpoints.md](docs/guides/continuation-checkpoints.md) |\n| MCP setup | [docs/guides/mcp-setup.md](docs/guides/mcp-setup.md) |\n| Privacy | [docs/reference/privacy.md](docs/reference/privacy.md) |\n| Security | [docs/reference/security-story.md](docs/reference/security-story.md) |\n| Releases (maintainers) | [docs/guides/release.md](docs/guides/release.md) |\n\nWebsite docs mirror: [https://3notch.dev/docs/](https://3notch.dev/docs/).\n\n---\n\n## Boundaries\n\n- Local files by default — no hosted relay, account system, or telemetry\n- No vector DB / native DB dependency\n- No arbitrary shell execution through MCP\n- You move bytes; 3Notch validates, scans, hashes, and stores them\n\nRegression guard: `tests/unit/no-deferred-commands.test.ts`.\n\n---\n\n## Contributing\n\nPrefer opening an issue before large features. See open issues and [CONTRIBUTING.md](CONTRIBUTING.md).\n\n```bash\ngit clone https://github.com/coldlogicAI/3notch.git\ncd 3notch\nnpm install\nnpm run lint && npm run type-check && npm run build\nnpm test && npm run test:e2e\nnpm run release:check\n```\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md).\n\nArchitecture reference (historical but still useful): [docs/archived-plans/v1/3notch-v1-technical-spec.md](docs/archived-plans/v1/3notch-v1-technical-spec.md).\n\n---\n\n## License\n\n[MIT](LICENSE) © 3Notch contributors\n","readmeFilename":"README.md"}