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)¶
Engram MCP in ~/.claude/settings.json:
Google Antigravity + Gemini¶
- Open the project in Antigravity.
- It detects
GEMINI.mdautomatically. - 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)¶
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¶
- Getting started — base installation.
- Engram conventions — the memory bus.
Canonical source
Derives from docs/shared/AGENT_SETUP.md.