Agent Client Protocol (ACP) Support
Documents how to launch and chat with ACP-compliant AI agents inside the Termide terminal IDE.
What this file does
Documents how to launch and chat with ACP-compliant AI agents inside the Termide terminal IDE.
When to use it
- You want to integrate an AI agent into a terminal-based IDE
- You need a reference for connecting Claude Code or Goose via stdio
- You are building a chat UI that communicates with agents over JSON-RPC 2.0
- You plan to expose editor capabilities to an agent through tool integration
Assumes this stack
Agent Client Protocol (ACP) Support
Termide now supports the Agent Client Protocol (ACP), allowing you to integrate AI agents directly into the terminal IDE.
Getting Started
-
Open the Agent Panel:
- Press
Ctrl+Space. - Or open the Command Palette (
Ctrl+K) and select "Toggle AI Agent".
- Press
-
Connect to an Agent:
- When the panel opens, you will be prompted to enter a command.
- Enter the command to launch your ACP-compliant agent.
- Examples:
npx claude-code(Claude Code)goose(Goose Agent)- Custom scripts that speak ACP over stdio.
-
Chat:
- Once connected, use the input box to send messages to the agent.
- The agent's responses will appear in the chat history.
- To stop the agent, press
Ctrl+Cwhile the agent panel is focused.
Architecture
The ACP implementation consists of:
src/lib/ACP.ts: The low-level JSON-RPC client that handles communication overstdio.src/hooks/useACP.ts: A React hook managing the agent lifecycle and message state.src/components/AgentPanel.tsx: The UI component for the chat interface.
Supported Features
- Stdio Transport: Launches agents as subprocesses using standard input/output.
- JSON-RPC 2.0: Full support for requests, responses, and notifications.
- Chat Interface: Basic conversational UI.
Future Roadmap
- Tool Integration: Expose Termide's file system and editor capabilities to the agent (e.g.,
read_file,open_tab). - Mcp Support: Enhanced support for Model Context Protocol features.
- Config: Save preferred agent commands in user settings.
What's inside
3 setup steps, 3 architecture files, 3 supported features, 3 roadmap items
Change this for your project
- Replace
npx claude-codewith your own agent launch command - Replace
goosewith your own agent launch command - Replace
src/lib/ACP.tswith your own file path if different - Replace
src/hooks/useACP.tswith your own file path if different
Where it goes
Save in docs/ or the repository root. Gives agents and new contributors a map of the codebase.
Related Documents
Design Document: BharatSeva AI
Describes a 10-agent AWS system that helps India's informal workers access government schemes via voice-first, serverless architecture.
OpenClaw Enterprise Transformation Plan
Transforms a single-user AI agent into a dual-mode platform supporting both viral open-source and Fortune 500 enterprise deployments through phased security, IAM, audit, multi-tenancy, and Kubernetes features.
University of Guelph Rocketry Club - Complete Tech Stack
Documents the full tech stack of a university rocketry club website with AI chatbot, member management, and project showcases.
Qwen Image and Edit: Open-sourcing and Local GGUF Generations with Lightning
Documents the Qwen-Image and Qwen-Image-Edit models, covering architecture, training, benchmarks, ComfyUI setup, and prompting techniques for local GGUF deployment.