Files
codewhale/AGENTS.md
T
Hunter Bown 3f8d04178c feat: v0.3.5 — smart context offloading, full MCP protocol, Duo mode, project_map tool
- Intelligent context offloading: large tool results (>15k chars) auto-moved to RLM memory
- Persistent history context: compacted messages offloaded to RLM history variable
- Full MCP protocol: SSE transport, Resources (resources/list, resources/read), Prompts (prompts/list, prompts/get)
- mcp_read_resource and mcp_get_prompt virtual tools exposed to the model
- Dialectical Duo mode with Player/Coach TUI rendering
- Dynamic system prompt refresh at each turn for up-to-date RLM/Duo/working-set context
- project_map tool for automatic codebase structure discovery
- delegate_to_agent alias for streamlined sub-agent delegation
- Default theme changed to Whale with updated color palette
- Fix MCP test compilation for updated McpServerConfig struct shape
- Fix clippy warnings (strip_prefix, inspect_err, flatten, is_some_and)
2026-01-30 06:02:43 -06:00

1.8 KiB

Project Instructions

This file provides context for AI assistants working on this project.

Project Type: Rust

Commands

  • Build: cargo build
  • Test: cargo test
  • Run: cargo run
  • Check: cargo check
  • Format: cargo fmt
  • Lint: cargo clippy

Project: deepseek-cli

Documentation

See README.md for project overview.

Version Control

This project uses Git. See .gitignore for excluded files.

Advanced Capabilities

Model Context Protocol (MCP)

This CLI supports MCP for extending tool access.

  • Use mcp_read_resource to read context from external servers.
  • Use mcp_get_prompt to leverage pre-defined expert prompts from servers.
  • You can connect to HTTP/SSE servers by adding their URL to mcp.json.

Multi-Agent Orchestration

For complex, multi-step tasks, you should delegate work:

  • Sub-agents: Use agent_spawn (or its alias delegate_to_agent) to launch a background assistant for a specific sub-task. Use agent_result to get their output.
  • Swarms: Use agent_swarm to orchestrate multiple sub-agents with dependencies. This is ideal for parallel exploration or complex refactoring where different parts of the project can be analyzed concurrently.

Project Mapping

  • Use project_map to get a comprehensive view of the codebase structure. This tool respects .gitignore and provides a summary of key files.

Guidelines

  • Proactive Investigation: Always start by exploring the codebase using project_map and file_search.
  • Parallelism: When you need to read multiple files or search across different areas, use parallel tool calls if possible.
  • Delegation: If a task is large, break it down into sub-tasks and use agent_swarm or agent_spawn.
  • Testing: Rigorously verify changes using cargo test and cargo check.

Important Notes