Skip to content

Agent and IDE setup

Belico Stack is model-agnostic. This guide covers setup for each tested IDE/model combination. The stack behaves identically across all of them — only the entry point each IDE reads on open changes.

Quick decision: which IDE/model?

Scenario Recommendation
Professional production (24+ papers/year) Claude Code + Claude Opus
$0 budget Local Qwen (Ollama) + Cline
Maximum privacy Local Qwen + Cline
Cheap fast API Qwen3-Max + Aider
Parallel multi-model OpenCode
Google stack Antigravity + Gemini

Setup per IDE

Claude Code (primary)

cd my-paper
claude
# Reads CLAUDE.md automatically

Engram MCP in ~/.claude/settings.json:

{
  "mcpServers": {
    "engram": {"command": "engram", "args": ["mcp"]}
  }
}

Google Antigravity + Gemini

  1. Open the project in Antigravity.
  2. It detects GEMINI.md automatically.
  3. Configure Engram MCP in settings (same as Claude Code).

Qwen Code CLI

npm install -g @qwenlm/qwen-code
export DASHSCOPE_API_KEY=your_key
cd my-paper
qwen   # Reads QWEN.md automatically

Aider (CLI, multi-model)

pip install aider-chat
aider --model claude-opus-4-6   # or qwen3-max, gpt-4o

Aider reads AGENTS_GENERIC.md as context. Tell it: "Read CLAUDE.md and apply all its rules."

Cursor / Windsurf / OpenCode

Native. They open the project and read CLAUDE.md automatically. They support Claude and GPT-4o. OpenCode lets you switch model per task.

Comparison by task

Stack task Claude Opus Gemini Qwen3-Max Local Qwen-Coder
Orchestration Excellent Good Good Fair
Sub-agent delegation Excellent Good Good Fair
Code generation Excellent Good Good Excellent
VERITAS verification Excellent Good Good Fair
Cost $$$ $$ $ Free
Privacy Cloud Cloud Cloud 100% Local

Multi-IDE troubleshooting

The agent can't find the stack

Make sure CLAUDE.md / QWEN.md / GEMINI.md is at the repo root. For unlisted IDEs, point them to AGENTS_GENERIC.md.

Engram does not respond

Run engram status in a terminal. Check the MCP config in ~/.{claude,qwen,gemini}/settings.json. One DB only: ~/.engram/engram.db (NEVER set ENGRAM_DATA_DIR).

The model ignores Belico.md rules

NO model reads Belico.md automatically. CLAUDE.md instructs the agent to load it via sub-agent/Engram. Verify the correct entry point is loaded.

See also

Canonical source

Derives from docs/shared/AGENT_SETUP.md.