What problem does it solve?
It eliminates the guesswork of building external clients that connect to RARA using the Agent Client Protocol (ACP) by stdio, ensuring your IDE plugin or agent can reliably create sessions, submit prompts, and handle runtime events.
Core Features & Use Cases
- ACP stdio transport integration: Connect external processes to RARA using JSON-RPC framed over stdin/stdout and implement the expected client lifecycle.
- Session and prompt workflow: Create, resume, and control sessions while submitting prompts that flow through RARA’s event bus.
- Event translation and control-plane extensibility: Correctly interpret how RARA translates internal AgentEvent variants into ACP SessionNotification messages, including tool progress, approvals, and error/warning surfaces.
Quick Start
Ask an AI assistant to generate a minimal ACP client that spawns rara acp, sends a session/create request with a working directory, then submits a session/prompt message and prints every incoming ACP notification.