{"id":26648416,"url":"https://github.com/stippi/code-assistant","last_synced_at":"2025-03-25T00:02:09.127Z","repository":{"id":260935258,"uuid":"882757178","full_name":"stippi/code-assistant","owner":"stippi","description":"An LLM-powered, autonomous coding assistant. Also offers an MCP mode.","archived":false,"fork":false,"pushed_at":"2025-03-17T16:24:43.000Z","size":804,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-17T16:37:11.698Z","etag":null,"topics":["agentic-ai","assistant","claude-3-5-sonnet","claude-3-7-sonnet","mcp-server"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/stippi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-11-03T17:21:41.000Z","updated_at":"2025-03-17T16:24:46.000Z","dependencies_parsed_at":"2024-11-03T18:26:30.112Z","dependency_job_id":"5a550b33-fcc0-4b3e-8d4e-e939fa6d39c8","html_url":"https://github.com/stippi/code-assistant","commit_stats":null,"previous_names":["stippi/code-assistant"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stippi%2Fcode-assistant","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stippi%2Fcode-assistant/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stippi%2Fcode-assistant/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stippi%2Fcode-assistant/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stippi","download_url":"https://codeload.github.com/stippi/code-assistant/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245372379,"owners_count":20604491,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agentic-ai","assistant","claude-3-5-sonnet","claude-3-7-sonnet","mcp-server"],"created_at":"2025-03-25T00:01:56.818Z","updated_at":"2025-03-25T00:02:09.076Z","avatar_url":"https://github.com/stippi.png","language":"Rust","readme":"# Code Assistant\n\n[![CI](https://github.com/stippi/code-assistant/actions/workflows/build.yml/badge.svg)](https://github.com/stippi/code-assistant/actions/workflows/build.yml)\n\nA CLI tool built in Rust for assisting with code-related tasks.\n\n## Features\n\n- **Autonomous Exploration**: The agent can intelligently explore codebases and build up working memory of the project structure.\n- **Reading/Writing Files**: The agent can read file contents and make changes to files as needed.\n- **Working Memory Management**: Efficient handling of file contents with the ability to load and unload files from memory.\n- **File Summarization**: Capability to create and store file summaries for quick reference and better understanding of the codebase.\n- **Interactive Communication**: Ability to ask users questions and get responses for better decision-making.\n- **MCP Server Mode**: Can run as a Model Context Protocol server, providing tools and resources to LLMs running in an MCP client.\n\n## Installation\n\nEnsure you have [Rust installed](https://www.rust-lang.org/tools/install) on your system. Then:\n\n```bash\n# Clone the repository\ngit clone https://github.com/stippi/code-assistant\n\n# Navigate to the project directory\ncd code-assistant\n\n# Build the project\ncargo build --release\n\n# The binary will be available in target/release/code-assistant\n```\n\n## Configuration in Claude Desktop\n\nThe `code-assistant` implements the [Model Context Protocol](https://modelcontextprotocol.io/introduction) by Anthropic.\nThis means it can be added as a plugin to MCP client applications such as **Claude Desktop**.\n\n### Configure Your Projects\n\nCreate a file `.code-assistant/projects.json` in your home directory.\nThis file adds available projects in MCP server mode (`list_projects` and `open_project` tools).\nIt has the following structure:\n\n```json\n{\n  \"code-assistant\": {\n    \"path\": \"/Users/\u003cusername\u003e/workspace/code-assistant\"\n  },\n  \"asteroids\": {\n    \"path\": \"/Users/\u003cusername\u003e/workspace/asteroids\"\n  },\n  \"zed\": {\n    \"path\": \"Users/\u003cusername\u003e/workspace/zed\"\n  }\n}\n```\n\nNotes:\n- The absolute paths are not provided by the tool, to avoid leaking such information to LLM cloud providers.\n- This file can be edited without restarting Claude Desktop, respectively the MCP server.\n\n### Configure MCP Servers\n\n- Open the Claude Desktop application settings (**Claude** -\u003e Settings)\n- Switch to the **Developer** tab.\n- Click the **Edit Config** button.\n\nA Finder window opens highlighting the file `claude_desktop_config.json`.\nOpen that file in your favorite text editor.\n\nAn example configuration is given below:\n\n```json\n{\n  \"mcpServers\": {\n    \"code-assistant\": {\n      \"command\": \"/Users/\u003cusername\u003e/workspace/code-assistant/target/release/code-assistant\",\n      \"args\": [\n        \"server\"\n      ]\n    }\n  }\n}\n```\n\n## Usage\n\nCode Assistant can run in two modes:\n\n### Agent Mode (Default)\n\n```bash\ncode-assistant --task \u003cTASK\u003e [OPTIONS]\n```\n\nAvailable options:\n- `--path \u003cPATH\u003e`: Path to the code directory to analyze (default: current directory)\n- `-t, --task \u003cTASK\u003e`: Task to perform on the codebase (required unless `--continue-task` or `--ui` is used)\n- `--ui`: Start with GUI interface\n- `--continue-task`: Continue from previous state\n- `-v, --verbose`: Enable verbose logging\n- `-p, --provider \u003cPROVIDER\u003e`: LLM provider to use [anthropic, open-ai, ollama, vertex] (default: anthropic)\n- `-m, --model \u003cMODEL\u003e`: Model name to use (defaults: anthropic=\"claude-3-7-sonnet-20250219\", openai=\"gpt-4o\", vertex=\"gemini-1.5-pro-latest\")\n- `--base-url \u003cURL\u003e`: API base URL for the LLM provider\n- `--tools-type \u003cTOOLS_TYPE\u003e`: Type of tool declaration [native, xml] (default: xml) `native` = tools via LLM provider API, `xml` = custom system message\n- `--num-ctx \u003cNUM\u003e`: Context window size in tokens (default: 8192, only relevant for Ollama)\n- `--record \u003cPATH\u003e`: Record API responses to a file for testing (currently Anthropic only)\n- `--playback \u003cPATH\u003e`: Play back a recorded session from a file\n\nEnvironment variables:\n- `ANTHROPIC_API_KEY`: Required when using the Anthropic provider\n- `OPENAI_API_KEY`: Required when using the OpenAI provider\n- `GOOGLE_API_KEY`: Required when using the Vertex provider\n\nExamples:\n```bash\n# Analyze code in current directory using Anthropic's Claude\ncode-assistant --task \"Explain the purpose of this codebase\"\n\n# Use OpenAI to analyze a specific directory with verbose logging\ncode-assistant -p open-ai --path ./my-project -t \"List all API endpoints\" -v\n\n# Use Google's Vertex AI with a specific model\ncode-assistant -p vertex --model gemini-1.5-flash -t \"Analyze code complexity\"\n\n# Continue a previously interrupted task\ncode-assistant --continue-task\n\n# Start with GUI interface\ncode-assistant --ui\n```\n\n### Server Mode\n\nRuns as a Model Context Protocol server:\n\n```bash\ncode-assistant server [OPTIONS]\n```\n\nAvailable options:\n- `-v, --verbose`: Enable verbose logging\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n","funding_links":[],"categories":["AI Agents","Code Execution \u0026 Automation Mcp Servers","Community Servers","پیاده‌سازی‌های سرور","Developer Tools","Rust","Table of Contents","File Management","📦 Other","📚 Projects (2474 total)","Coding Agents"],"sub_categories":["Code Assistants","🤖 \u003ca name=\"coding-agents\"\u003e\u003c/a\u003eعامل‌های کدنویسی","AI Services","MCP Servers"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstippi%2Fcode-assistant","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstippi%2Fcode-assistant","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstippi%2Fcode-assistant/lists"}