{"_id":"@aiguys/chirp-cli","name":"@aiguys/chirp-cli","dist-tags":{"latest":"0.2.0"},"versions":{"0.2.0":{"name":"@aiguys/chirp-cli","version":"0.2.0","description":"Chirp CLI - send notifications and manage Live Activities from the terminal","type":"module","bin":{"chirp":"dist/index.js"},"scripts":{"build":"tsc && node scripts/package-codex-plugin.mjs","dev":"tsx src/index.ts","typecheck":"tsc --noEmit","verify:codex-protocol":"node scripts/verify-codex-app-server.mjs","pretest":"node scripts/package-codex-plugin.mjs","test":"vitest run","prepack":"npm run build"},"keywords":["chirp","notifications","live-activities","cli","push"],"license":"MIT","homepage":"https://chirpapp.dev/integrations/codex-cli","bugs":{"url":"https://github.com/BradyMeighan/ChirpApp/issues"},"repository":{"type":"git","url":"git+https://github.com/BradyMeighan/ChirpApp.git","directory":"cli"},"engines":{"node":">=18"},"publishConfig":{"access":"public"},"dependencies":{"commander":"^13.1.0"},"devDependencies":{"@types/node":"^22.13.14","tsx":"^4.19.3","typescript":"^5.8.2","vitest":"^4.1.2"},"gitHead":"4ae9041eb80d752c32581b78d0af77ba2dd17c68","_id":"@aiguys/chirp-cli@0.2.0","_nodeVersion":"26.4.0","_npmVersion":"11.17.0","dist":{"integrity":"sha512-FXY2rbUf6IcpXMnSXJjNZXMViqltGspbFbhJpYxPLgo71tREzc1yIsm7MCcgUeRC9DvfXCz/0ITdFiyrguBT7g==","shasum":"933addb92a629a383130f270aba967e75a1c5352","tarball":"https://registry.npmjs.org/@aiguys/chirp-cli/-/chirp-cli-0.2.0.tgz","fileCount":50,"unpackedSize":167613,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIFHf2WN6bx83HHcYDIYQFZkh4W99TSt2p5hMmKkKGk8QAiEA/wpdGhln+F53sfoAIkUffxU14KcxGH13bBl+OD5JKGI="}]},"_npmUser":{"name":"aiguys","email":"brady@aiguys.net"},"directories":{},"maintainers":[{"name":"aiguys","email":"brady@aiguys.net"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/chirp-cli_0.2.0_1785192549662_0.5180914044471203"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-27T22:49:09.526Z","0.2.0":"2026-07-27T22:49:09.819Z","modified":"2026-07-27T22:49:10.038Z"},"maintainers":[{"name":"aiguys","email":"brady@aiguys.net"}],"description":"Chirp CLI - send notifications and manage Live Activities from the terminal","homepage":"https://chirpapp.dev/integrations/codex-cli","keywords":["chirp","notifications","live-activities","cli","push"],"repository":{"type":"git","url":"git+https://github.com/BradyMeighan/ChirpApp.git","directory":"cli"},"bugs":{"url":"https://github.com/BradyMeighan/ChirpApp/issues"},"license":"MIT","readme":"# @aiguys/chirp-cli\n\nChirp’s command-line client pairs a computer to the iPhone app, sends\nnotifications and Live Activities, installs Claude Code hooks, and can own a\nCodex App Server session with one-time phone approvals.\n\n## Install\n\n```bash\nnpm install --global @aiguys/chirp-cli\nchirp login\n```\n\nThen connect the tool you want Chirp to follow:\n\n```bash\nchirp setup claude\nchirp setup codex\n```\n\nThe explicit first-run order is install, authenticate the computer with\n`chirp login`, then run the provider-specific setup command. The setup command\nstill detects an unpaired computer and can launch pairing as a recovery path,\nbut the product walkthrough never assumes that an unexplained `chirp` binary\nor session already exists. `chirp setup claude` merges Chirp's status and\npermission hooks without replacing unrelated Claude settings, and\n`chirp doctor` verifies the complete account-to-phone-delivery rail.\n\n## Develop from source\n\n```bash\nnpm ci\nnpm test\nnpm run build\nnode dist/index.js --help\n```\n\nPairing uses a short device code and stores a scoped machine credential in\n`~/.chirp/config.json` with user-only permissions. It never copies a reusable\ncredential through a browser callback or reads repository-local credential\nfiles.\n\n## Coding agents\n\n```bash\n# First run on this computer\nnpm install --global @aiguys/chirp-cli\nchirp login\n\n# Then choose the integration\nchirp setup claude\nchirp setup codex\nchirp codex \"check this project and ask before any privileged action\"\n```\n\n- Claude Code’s `PermissionRequest` hook can return a one-time allow or deny\n  decision while the exact upstream request remains live. Lock Screen actions\n  require device authentication and may prompt for Face ID, Touch ID, or\n  passcode/unlock before the decision is sent.\n- `chirp setup codex` pairs the computer when needed, registers the exact\n  bundled local marketplace, installs/enables Chirp through the official Codex\n  CLI, and reads the installed state back before reporting success. Restart\n  Codex, then review and trust the exact hook for that host. In Codex CLI, open\n  `/hooks`; desktop hook-review availability remains a release-walkthrough\n  gate. Use `--manual` to print the equivalent commands without changing Codex\n  plugin configuration.\n- The public Plugins Directory listing is not live until the plugin has been\n  submitted, approved, explicitly published, and clean-installed. The local\n  preview does not imply public availability.\n- The trusted Chirp Codex plugin can return a one-time phone decision.\n  `chirp codex` remains an App Server alternative for a Chirp-owned client;\n  `notify`, wrappers, and MCP alone cannot answer a native approval prompt.\n- The default approval window is up to 60 minutes, capped by upstream liveness.\n  Heartbeats, exact-request hashes, device-bound one-time capabilities, and\n  fail-closed cancellation prevent a late action from applying to another\n  request.\n","readmeFilename":"README.md","_rev":"1-2fd9b4a566e4a6e7ec0bd8847339bd15"}