Quick Start
1. Install OpenCode
curl -fsSL https://opencode.ai/install | bash
2. Add AION to Your Project
cd your-project
git clone https://github.com/ztxtech/aion.git .opencode
3. Run
bash cli.sh
Or run manually:
opencode run --agent agent "Read the root task files and the .opencode contract first, then complete the task end-to-end."
AION Workflow
Finite-state execution with iterative refinement and dual-review gates
%%{init: {'theme': 'base', 'flowchart': { 'useMaxWidth': true, 'htmlLabels': false, 'curve': 'basis', 'nodeSpacing': 80, 'rankSpacing': 90, 'padding': 20 }, 'themeVariables': { 'primaryColor': '#ffffff', 'primaryTextColor': '#1e293b', 'primaryBorderColor': '#7C3AED', 'lineColor': '#94a3b8', 'secondaryColor': '#f8fafc', 'tertiaryColor': '#f1f5f9', 'fontFamily': 'Inter, sans-serif', 'fontSize': '15px' }}}%%
flowchart LR
classDef default fill:#ffffff,stroke:#7C3AED,stroke-width:2px,color:#1e293b,rx:6px,ry:6px
classDef task fill:#ffffff,stroke:#7C3AED,stroke-width:3px,color:#1e293b
classDef review fill:#fffbeb,stroke:#f59e0b,stroke-width:3px,color:#1e293b
classDef pass fill:#ecfdf5,stroke:#10b981,stroke-width:2px,color:#047857
classDef fail fill:#fef2f2,stroke:#ef4444,stroke-width:2px,color:#dc2626
classDef rebuttal fill:#fff7ed,stroke:#f97316,stroke-width:2px,color:#c2410c
classDef loop fill:#f8fafc,stroke:#8B5CF6,stroke-width:2px,color:#7C3AED,stroke-dasharray: 5 5
A["01 Task"] --> B["02 Info"]
B --> C["03 Run"]
C --> D{"04 Review"}
D -->|PASS| E["Done"]
D -->|FAIL| F["Fix"]
F --> G["Loop"]
G -.-> B
G -.-> C
class A,B,C task
class D review
class E pass
class F fail
class G loop
style A width:90px
style B width:90px
style C width:90px
style D width:120px
style E width:80px
style F width:80px
style G width:80px
The AION workflow operates as a finite-state machine with mandatory dual-review gates. After Task Analysis and Information collection, the coder runs experiments. Every output must pass both ts-critic (time-series expert + Pareto governance) and c-critic (final minimal-context cold-start critique). On Pass, the system finalizes with memory sync and trace logging. On Fail, the rebuttal protocol triggers, and the system loops back to gather more evidence or refine the experiment. No output leaves the system without passing layered critics.
Component Overview
AION is described by concrete components rather than fixed architectural layers: named agents own work, native skills load only when needed, protocols and memory preserve execution state, and critic plus runner gates verify the result before delivery.
Key Components
6 Specialized Agents
Main orchestrator, requirements analyst, information collector, coder, ts-critic, and c-critic with strict governance hierarchy.
Native OpenCode Skills
Task-aware capabilities load only when needed for search, planning, time-series analysis, experiments, reports, safety, and document input.
8 Runtime Protocols
Dispatch, reportback, rebuttal, stop-go, lifecycle, memory-sync, runtime-events, and compaction protocols.
5 Evaluation Contracts
Test suites, graders, scorecards, regression matrices, and release gates for quality assurance.
Memory & Trace
Per-task execution traces and cross-task persistent memory with context snapshots and decision logs.
Built on OpenCode
Extends the OpenCode AI coding agent with time-series-specific governance, skills, and safety gates.
Governance Hierarchy
The main agent owns dispatch and execution, but does not own closeout authority above the critics. In blocker judgment, rebuttal verdicts, route rollback, stop-go, and final-delivery decisions: c-critic > ts-critic > main agent > other subagents.
BibTeX
@misc{zhan2026aion,
title={AION: Next-Generation Tasks and Practical Harness for Time Series},
author={Tianxiang Zhan and Xiaobao Song and Tong Guan and Shirui Pan and Ming Jin},
year={2026},
eprint={2605.25045},
archivePrefix={arXiv},
url={https://arxiv.org/abs/2605.25045}
}