code-assistant

code-assistant

A Rust-based MCP server for autonomous code analysis, exploration, and modification.

113
Stars
18
Forks
14
Releases

Overview

Code Assistant is a Rust-based AI coding assistant that can run as both a CLI/GUI application and a headless MCP server to be consumed by MCP clients such as Claude Desktop. It offers a multi-interface architecture: a modern GUI based on Zed's GPUI framework, a terminal interface, and a headless MCP server mode for integration with external tools. The MCP server implements compatibility with the Agent Client Protocol (ACP), using JSON-RPC over stdin/stdout in ACP mode to support pending messages, real-time streaming, and tool execution with proper permission handling. It supports adaptive tool invocation modes to accommodate different LLM capabilities: native function calling, XML-style streaming tags, and triple-caret blocks. Real-time streaming processors display tool invocations as they stream, with smart filtering to avoid unsafe tool combinations. Each chat session is linked to a specific project with persistent state, working memory, and draft messages (attachments supported), and sessions are anchored to the initial project context. The system can automatically load repository guidance by inserting AGENTS.md (or CLAUDE.md fallback) into the model's system context to align behavior with repo-specific instructions. Additional features include session compaction and ACP-compatible tooling behavior.

Details

Owner
stippi
Language
Rust
License
MIT License
Updated
2025-12-07

Features

Multi-Modal Tool Execution

Adapts to LLM capabilities with pluggable tool invocation modes—native function calling, XML-style tags, and triple-caret blocks.

Real-Time Streaming Interface

Streaming processors parse and display tool invocations as they stream, with smart filtering to prevent unsafe tool combinations.

Session-Based Project Management

Each chat session is tied to a specific project, with persistent state, working memory, and draft messages (attachments supported).

Multiple Interface Options

GUI (Zed GPUI), terminal, or headless MCP server mode for integration with MCP clients like Claude Desktop.

Agent Client Protocol (ACP) Support

Full ACP compatibility enabling seamless JSON-RPC communication with editors such as Zed.

Session Compaction

Before running out of context space, the agent generates a session summary and continues work.

Auto-Loaded Repository Guidance

Automatically includes AGENTS.md (or CLAUDE.md fallback) from the project root in system context to align behavior.

Editor Integrations (Claude Desktop & ACP)

Provides MCP setup guidance and configurations to integrate with Claude Desktop and ACP-enabled editors.

Audience

DevelopersIntegrate an autonomous coding assistant into their workflow for code analysis and modification.
EditorsUse ACP-compatible editors like Zed to access real-time code assistance via MCP.
TeamsCoordinate multi-user workflows using session-based project management.

Tags

MCPACPCode analysisCode modificationRustGUICLISession managementTool invocationJSON-RPCZedClaude DesktopRepository guidance