Agon
Agon is a Claude Code plugin that autonomously drives AI research from a one-line topic to running experiments. It uses closed-loop agents that plan, implement, audit, and review each other, with all handoffs stored in files for recoverability and auditability. It is for researchers and developers who want to automate large-scale research workflows.
✨ Key features
- Autonomous research pipeline: topic → idea → proposal → experiment
- Closed-loop agent collaboration with auditing and review
- File-based handoffs for recoverable and auditable runs
- Commands for idea, proposal, experiment, and literature review
- Supports DeepSeek-backed Claude Code via claude-ds wrapper
- Configurable model routing and parallelism via .settings.toml
🎯 Use cases
- Automatically survey literature on a topic and generate a landscape report
- Brainstorm and refine research ideas from a vague topic
- Generate and review research proposals
- Run experiments with coordinated scientist, coder, auditor, and reviewer roles
- Debug experiments with step-by-step approval
📦 Installation
🧰 Requirements: Requires Claude Code (or claude-ds for DeepSeek), a data workspace (agon-artifacts), and optionally a DeepSeek API key for claude-ds.
Clone the repositories and place them side by side:
git clone https://github.com/AutoResearch-Factory/Agon.git
git clone https://github.com/AutoResearch-Factory/agon-artifacts.git
Then run Claude Code from the artifacts directory:
cd agon-artifacts
claude --plugin-dir ../Agon --dangerously-skip-permissions --effort medium
For claude-ds (DeepSeek-backed), set up symlinks and add the function to ~/.bashrc as described in the README.
🚀 Usage
In Claude Code, use commands like:
/deep-lit-tick Exhaustively survey the literature on <topic>, and write the result to topics/mmdd-<slug>-landscape.md.
/idea-tick <topic-slug> <topic> is becoming important. Brainstorm several research ideas.
/proposal-tick Generate proposals for these ideas.
/experiment-tick <slug> Start the experiment.
⚠️ Good to know
Requires --dangerously-skip-permissions for unattended operation, which may pose security risks; it is recommended to run in an isolated environment.
❓ FAQ
What is the purpose of --dangerously-skip-permissions?
It allows subagents to write files, launch experiments, and call tools without permission prompts, enabling unattended runs. It is required for the loops to work.
How do I use Agon with DeepSeek?
Install claude-ds by setting up the ~/.claude-ds directory with symlinks and adding the claude-ds() function to ~/.bashrc, then run claude-ds instead of claude.
What is the expected data workspace layout?
The workspace (agon-artifacts) should contain directories: topics/, ideas/, and workspace/. Optional settings are in .settings.toml.
Can I customize model routing or parallelism?
Yes, you can start from .settings.example.toml and create .settings.toml to customize model routing and parallelism.
📊 Repository
🤖 Overview, features, install steps and FAQ were generated from the project's README on Sep 4, 2026. Always check the original source before running commands.