{"_id":"@baldaworks/acpchat","name":"@baldaworks/acpchat","dist-tags":{"latest":"1.1.1"},"versions":{"1.1.1":{"bin":{"acpchat":"acpchat.js"},"description":"Meta package for acpchat","engines":{"node":">=16"},"keywords":["ai","llm","acp","agent","cli","repl","interactive","chat"],"license":"MIT","name":"@baldaworks/acpchat","optionalDependencies":{"@baldaworks/acpchat-darwin-arm64":"1.1.1","@baldaworks/acpchat-darwin-x64":"1.1.1","@baldaworks/acpchat-linux-arm64":"1.1.1","@baldaworks/acpchat-linux-x64":"1.1.1","@baldaworks/acpchat-win32-x64":"1.1.1"},"repository":{"type":"git","url":"git+https://github.com/baldaworks/acpchat.git"},"version":"1.1.1","gitHead":"74d0226a30910f9ea26c4bd2daf36561b0fc50bf","_id":"@baldaworks/acpchat@1.1.1","bugs":{"url":"https://github.com/baldaworks/acpchat/issues"},"homepage":"https://github.com/baldaworks/acpchat#readme","_nodeVersion":"24.19.0","_npmVersion":"11.17.0","dist":{"integrity":"sha512-6Pr5LPtK+Gid0Q7OVz7RWqC95zTQqKbFejlLhVbiJ0p6xUUsoF3jSiGnCrePPd3lSzvf13nUfGCO3dLmXIw51Q==","shasum":"3017340753d1a357e3c7ba7c69173381e80767ab","tarball":"https://registry.npmjs.org/@baldaworks/acpchat/-/acpchat-1.1.1.tgz","fileCount":4,"unpackedSize":8374,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQD98pWH2DxbPlGA0EJpTFdk4Qj67zoR0JPt33OH0Zc4HAIhAKpPsMHFtz9kgF16K0EjBCLDyqt8F2+RsQJpP8LXiwVV"}]},"_npmUser":{"name":"metalagman","email":"alexey.samoylov@gmail.com"},"directories":{},"maintainers":[{"name":"metalagman","email":"alexey.samoylov@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/acpchat_1.1.1_1788258995872_0.7090590761089128"},"_hasShrinkwrap":false}},"time":{"created":"2026-09-01T10:36:35.457Z","1.1.1":"2026-09-01T10:36:36.148Z","modified":"2026-09-01T10:36:36.574Z"},"maintainers":[{"name":"metalagman","email":"alexey.samoylov@gmail.com"}],"description":"Meta package for acpchat","homepage":"https://github.com/baldaworks/acpchat#readme","keywords":["ai","llm","acp","agent","cli","repl","interactive","chat"],"repository":{"type":"git","url":"git+https://github.com/baldaworks/acpchat.git"},"bugs":{"url":"https://github.com/baldaworks/acpchat/issues"},"license":"MIT","readme":"# acpchat\n\n[![test](https://github.com/baldaworks/acpchat/actions/workflows/test.yml/badge.svg?branch=main)](https://github.com/baldaworks/acpchat/actions/workflows/test.yml)\n[![lint](https://github.com/baldaworks/acpchat/actions/workflows/lint.yml/badge.svg?branch=main)](https://github.com/baldaworks/acpchat/actions/workflows/lint.yml)\n[![security](https://github.com/baldaworks/acpchat/actions/workflows/security.yml/badge.svg?branch=main)](https://github.com/baldaworks/acpchat/actions/workflows/security.yml)\n[![release](https://github.com/baldaworks/acpchat/actions/workflows/omnidist-release.yml/badge.svg)](https://github.com/baldaworks/acpchat/actions/workflows/omnidist-release.yml)\n[![npm](https://img.shields.io/npm/v/@baldaworks/acpchat)](https://www.npmjs.com/package/@baldaworks/acpchat)\n[![License](https://img.shields.io/github/license/baldaworks/acpchat)](LICENSE)\n[![Version](https://img.shields.io/github/v/tag/baldaworks/acpchat?label=version)](https://github.com/baldaworks/acpchat/tags)\n\n**Talk to ACP agents interactively from your terminal.**\n\n`acpchat` starts any stdio Agent Client Protocol (ACP) server command and gives\nyou a focused terminal chat / REPL for sending prompts, testing sessions, and handling\npermission requests.\n\nUse it when you want to try an ACP provider directly before embedding it in an\nagent runtime, app, or automation workflow.\n\n## What You Get\n\n| Capability | Behavior |\n| --- | --- |\n| Interactive ACP chat | Opens a prompt loop against a stdio ACP server command. |\n| Session setup | Creates an ACP session before the first user turn. |\n| Model selection | Requests a provider model with `--model` when supported. |\n| Mode selection | Requests a provider mode with `--mode` when supported. |\n| Permission handling | Lets you choose from numbered permission options in the terminal. |\n| Quiet lifecycle logs | Keeps output focused unless `--debug` is enabled. |\n| Provider agnostic | Works with OpenCode, Codex, Claude Code, Pi, and any executable that speaks ACP over stdio. |\n\n## Try It\n\nInstall globally:\n\n```sh\nnpm install -g @baldaworks/acpchat@latest\n```\n\nRun once with `npx`:\n\n```sh\nnpx @baldaworks/acpchat@latest -- <acp-server-cmd> [args...]\n```\n\nStart a chat:\n\n```sh\nacpchat -- opencode acp\nacpchat --model openai/gpt-5.4 --mode coding -- opencode acp\nacpchat --reasoning-effort high -- npx -y @normahq/codex-acp-bridge@latest\nacpchat -- npx -y @normahq/codex-acp-bridge@latest\nacpchat -- npx -y @zed-industries/claude-code-acp@latest\nacpchat --debug -- npx -y pi-acp\n```\n\n## Provider Commands\n\n| Provider | Command |\n| --- | --- |\n| OpenCode | `acpchat -- opencode acp` |\n| OpenCode with model/mode | `acpchat --model openai/gpt-5.4 --mode coding -- opencode acp` |\n| Codex | `acpchat -- npx -y @normahq/codex-acp-bridge@latest` |\n| Codex with reasoning effort | `acpchat --reasoning-effort high -- npx -y @normahq/codex-acp-bridge@latest` |\n| Claude Code | `acpchat -- npx -y @zed-industries/claude-code-acp@latest` |\n| Pi | `acpchat -- npx -y pi-acp` |\n| Generic ACP | `acpchat -- <acp-server-cmd> [args...]` |\n\nThe `--` separator is required. Arguments before `--` are treated as\n`acpchat` flags; arguments after it are passed to the ACP server command.\n\n## Interaction\n\n- Type a prompt and press Enter to run a turn.\n- Type `exit` or `quit` to close the session.\n- If ACP permission requests arrive, choose from the numbered options.\n- Use `--debug` when you need lifecycle and inspector diagnostics.\n\n## Use Cases\n\n- Smoke-test an ACP provider before wiring it into an ADK or custom runtime.\n- Compare model and mode behavior without writing integration code.\n- Reproduce provider permission flows from a terminal.\n- Debug whether a local ACP command can start, initialize, and complete turns.\n\n## Flags\n\n| Flag | Purpose |\n| --- | --- |\n| `--model <id>` | Request a session model via ACP `session/set_config_option` config id `model`. |\n| `--mode <id>` | Request a session mode via ACP `session/set_config_option` config id `mode`, with legacy `session/set_mode` fallback. |\n| `--reasoning-effort <effort>` | Request a session reasoning effort via ACP `session/set_config_option` config id `reasoning_effort`. |\n| `--debug` | Enable debug logs. |\n| `-h`, `--help` | Show command help. |\n\nUnsupported config option requests fail session setup. Legacy `session/set_mode`\nfallback failures are ignored only when the server reports the method as\nunsupported.\n\n## Repository\n\n- GitHub: <https://github.com/baldaworks/acpchat>\n\n## Contact\n\n- Issues: <https://github.com/baldaworks/acpchat/issues>\n- Maintainer: [@metalagman](https://github.com/metalagman)\n\n## License\n\nMIT. See the repository [LICENSE](https://github.com/baldaworks/acpchat/blob/main/LICENSE).\n","readmeFilename":"README.md","_rev":"1-1e3815e7b4917c1d1f3e5f4c073f6a08"}