Extending It

MCP servers

Connect external tools and data sources so the agent can do more:

min-agent mcp -h          # Show all MCP subcommands
min-agent mcp list        # List configured servers

Add a stdio server (local process):

min-agent mcp add filesystem npx -y @modelcontextprotocol/server-filesystem /tmp

Add a remote server (HTTP):

min-agent mcp add remote --url https://example.com/mcp --token "$TOKEN"

More subcommands:

min-agent mcp info <name>     # Show details of a server
min-agent mcp check           # Test connectivity of all servers
min-agent mcp enable <name>   # Enable a server
min-agent mcp disable <name>  # Disable a server
min-agent mcp remove <name>   # Remove a server

Config is written to the global ~/.min-agent/mcp.json by default; add --project to write to .min-agent/mcp.json in the current project. Standard transports including SSE and streamable-http are supported.

Skills

Reusable instruction sets the agent loads automatically. Define a workflow once and use it anywhere:

min-agent skills -h       # Show all skills subcommands
min-agent skills list     # List skills and their enabled state
min-agent skills info <name>     # Show details of a skill
min-agent skills new <name>      # Create a new skill
min-agent skills enable <name>   # Enable a skill
min-agent skills disable <name>  # Disable a skill

Use /skills in chat to manage them. Skills are discovered from (later wins over earlier):

• ~/.agents/skills/
• .min-agent/skills/
• .agents/skills/
• .opencode/skills/
• .claude/skills/

Built-in skills ship with the package; your own copies with the same name take precedence.

Project rules

Add an AGENTS.md or RULES.md to your project root to define custom instructions the agent will follow:

# Project rules

- Use TypeScript with ESM
- No comments unless the logic is genuinely complex

Rules are loaded from (later wins over earlier):

• Global: ~/.min-agent/rules.md (edit it with min-agent rules edit)
• Project: ./AGENTS.md or ./RULES.md or ./.min-agent/AGENTS.md
• Config: the instructions array in ~/.min-agent/config.json

Slash commands

Use / commands in chat for quick actions — see While Chatting.