iflow-acp

iflow-acp is a thin ACP proxy adapter for iFlow CLI.

It exposes ACP over stdio and forwards all protocol traffic to:

iflow --experimental-acp

Why this architecture

Instead of reimplementing ACP translation logic, this project delegates ACP behavior to iFlow's native ACP implementation and focuses on:

• robust process management
• compatible entrypoint for ACP clients
• clear error handling
• testable, low-maintenance adapter surface

Prerequisites

• Node.js 20+
• iFlow CLI installed and available in PATH

npm install -g @iflow-ai/iflow-cli

Install

npm install -g @synth-coder/iflow-acp

Then configure your ACP client (example with a custom command):

{
  "agent_servers": {
    "iflow": {
      "type": "custom",
      "command": "iflow-acp",
      "args": [],
      "env": {}
    }
  }
}

Runtime behavior

Default mode

iflow-acp

Runs iFlow ACP mode:

iflow --experimental-acp

Terminal login mode

iflow-acp --terminal-login

Passes through to iFlow interactive mode (without forcing --experimental-acp).

Environment variables

• IFLOW_ACP_IFLOW_COMMAND – override executable (default: iflow)
• IFLOW_ACP_IFLOW_ARGS – extra args appended before CLI passthrough args

Example:

IFLOW_ACP_IFLOW_COMMAND=iflow.cmd IFLOW_ACP_IFLOW_ARGS="--model kimi-k2.5 --yolo" iflow-acp

Migration notes

This repository is now iflow-only.

• Legacy RPC translation internals were removed.
• ACP behavior is delegated to iFlow native ACP mode.
• The adapter acts as a process-managed wrapper for ACP clients.

Treat 0.1.0 as a breaking migration baseline.

Development

npm install
npm run quality
npm run smoke

Quality gate includes:

• lint
• strict typecheck
• coverage check (>= 80% lines/functions/branches/statements)
• build

Release verification checklist

Before publishing:

npm run quality
npm run smoke

Then validate with an ACP client:

1. initialize succeeds
2. session/new returns a valid session id
3. session/prompt returns streamed output and ends normally

Open-source attribution

This project is a derivative work based on a public MIT-licensed ACP adapter codebase.

• Historical upstream project: https://github.com/svkozak/pi-acp
• Current repository keeps visible git history and fork lineage.
• The original MIT license notice is preserved in LICENSE.
• This repository contains substantial refactoring and productization focused on an iflow-only thin proxy architecture.

License

MIT