Package Exports
- opencode-autoresearch
- opencode-autoresearch/dist/index.js
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (opencode-autoresearch) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
Auto Research
v3.1.0 — OpenCode-only npm package
Auto Research is a subagent-first autonomous iteration engine for OpenCode. It keeps the existing /autoresearch command surface intact and adds specialized mode workflows.
Inspired by Karpathy's autoresearch. The core loop is still the same:
Modify -> Verify -> Keep or Discard -> Repeat
Runtime surfaces
| Surface | Entry point |
|---|---|
| OpenCode | /autoresearch, /autoresearch:plan, /autoresearch:debug, /autoresearch:fix, /autoresearch:learn, /autoresearch:predict, /autoresearch:scenario, /autoresearch:security, /autoresearch:ship |
Install
npm install -g opencode-autoresearch
opencode-autoresearch doctorSee docs/OPENCODE_INSTALL.md for full install and verification steps.
Core loop
Auto Research requires a goal, scope, and a mechanical verification command. It then:
- Baselines the current state.
- Makes one focused experiment.
- Verifies it mechanically.
- Keeps strict improvements and discards regressions.
- Records the result and continues until the stop condition is met.
Runtime artifacts
| Artifact | Purpose |
|---|---|
.autoresearch/state.json |
Checkpoint state for the current run |
autoresearch-results.tsv |
Iteration log |
autoresearch-report.md |
End-of-run report |
autoresearch-memory.md |
Reusable memory for later runs |
Development
npm run typecheck # Type check the TypeScript sources
npm run build # Compile TypeScript to dist/
npm pack --dry-run # Preview shipped package contentsRepository layout
src/ # TypeScript source (runtime helpers, CLI, subagent pool)
dist/ # Compiled JavaScript output
commands/ # OpenCode command surfaces
skills/autoresearch/ # Skill bundle with references
hooks/ # Shell hooks for session lifecycle
docs/ # Install and architecture docs
.autoresearch/ # Runtime state directory
.opencode-plugin/ # Plugin manifestNotes
- This is an OpenCode-only package. No Claude or Codex runtime is supported.
- The CLI uses Node.js ESM modules.
- Python scripts were used in earlier releases and are no longer shipped.