agentsys is a free, open source version control & collaboration project written in JavaScript and released under MIT. It has 986 GitHub stars, 115 forks and 0 open issues, and was last pushed 4 days ago. On this registry it ranks #25 of 30 tracked projects in Version Control & Collaboration, with 5 head-to-head comparisons available.

What is agentsys?

AgentSys is a modular runtime and orchestration system for AI agents — a marketplace and installer that ties together 24 plugins, 49 agents, and 44 skills into gated development pipelines — built for developers and teams working in Claude Code, Codex CLI, OpenCode, Cursor, or Kiro who want the work around code generation automated, not only the code generation itself.

What it is

AgentSys is a modular runtime and orchestration system for AI agents, written in JavaScript and released under the MIT licence. It is the marketplace and installer for 24 plugins, each of which lives in its own standalone repository under the agent-sh organisation; installing AgentSys fetches those plugins automatically from their repos. Across the ecosystem the project counts 49 agents — 39 file-based plus 10 role-based specialists in audit-project — and 44 skills, with roughly 30,000 lines of library code and 3,518 tests behind it. It runs on five platforms: Claude Code, Codex CLI, OpenCode, Cursor, and Kiro.

The problem it targets is the work surrounding code generation rather than the generation itself. The project's own framing is that AI models can already write code, and the hard part is everything else: task selection, branch management, code review, artifact cleanup, CI, PR comments, and deployment. AgentSys replaces hand-run, per-session agent prompting and manual phase tracking with structured pipelines that enforce phase gates, so an agent cannot skip a step, and with persistent state that survives session boundaries, so interrupted work resumes instead of restarting.

Key capabilities

  • Marketplace and installer for 24 plugins, each distributed as a standalone repository under the agent-sh org and fetched automatically at install time.
  • 49 agents, each with a single responsibility, a specific model assignment, and defined inputs and outputs — 39 file-based agents plus 10 role-based specialists in audit-project.
  • 44 skills that compose into structured pipelines with enforced phase gates between steps.
  • Persistent state across session boundaries, so work survives interruptions.
  • Certainty-graded findings: HIGH means definitely a problem and is safe to auto-fix, MEDIUM means probably a problem and needs context, LOW means possibly a problem and needs human judgment.
  • Hybrid execution: regex, AST analysis, and static analysis do detection, while LLM calls are reserved for synthesis, planning, and review — reported as 77% fewer tokens for /drift-detect versus multi-agent approaches.
  • Commands such as /drift-detect, /can-i-help, and /onboard, plus CLI entry points agentsys install, agentsys --tool codex, and agentsys --tool opencode.

Who uses it and how

  • Developers and teams in Claude Code, Codex CLI, OpenCode, Cursor, or Kiro who want task selection, branch management, code review, artifact cleanup, CI, PR comments, and deployment handled by agents rather than manually.
  • Teams standardising on more than one assistant, installing the same plugin set per tool through agentsys --tool codex and agentsys --tool opencode.
  • Windows and Linux users running the suite or its CI, since the test suite now runs on both platforms.
  • Cost-sensitive teams choosing a model tier: the published benchmark on glide-mq puts Sonnet with AgentSys at $0.66 per task against $1.10 for Opus without it.
  • Maintainers of larger codebases who want the audit-project specialists, a set exercised against more than 1,000 repositories during development.

Getting started

Install through the marketplace or the npm installer; agentsys install then fetches the plugins automatically from their repositories. On Codex CLI or OpenCode the install path is agentsys --tool codex or agentsys --tool opencode.

How it compares

No competing orchestration runtime or list of paid products it replaces is given in the facts, so AgentSys stands alone in this registry. The adjacent tools named alongside it are complementary rather than competing: agnix is a CLI and LSP linter that validates agent configuration against 423 rules, and tiyuvta inference is hosted, OpenAI- and Anthropic-compatible LLM inference aimed at agents running continuously.

When to use it — and when not to

AgentSys fits teams already committed to one of its five supported platforms and willing to pay for LLM calls per task, since the published benchmark puts a single run between $0.66 and $1.95 depending on model. It is a poor fit for anyone outside those platforms. The install path has also been unstable: version 6.0.2 had to delete two adapter install.sh scripts that destroyed a working install while reporting success, and had to fix Windows execution by resolving the Claude Code executable with where.exe instead of assuming claude.cmd. Teams that cannot absorb that kind of churn in an installer should treat the release line as young.

project readme (upstream, from github) — read inline

AgentSys

A modular runtime and orchestration system for AI agents.

npm version npm downloads CI GitHub stars License: MIT Website Mentioned in Awesome Claude Code

24 plugins · 49 agents · 44 skills (across all repos) · 30k lines of lib code · 3,518 tests · 5 platforms
Plugins distributed as standalone repos under agent-sh org - agentsys is the marketplace & installer

⚡ Running this agent 24/7? tiyuvta inference — hosted LLM inference built for always-on agents, OpenAI/Anthropic-compatible APIs.

Commands · Installation · Website · Discussions

Built for Claude Code · Codex CLI · OpenCode · Cursor · Kiro

New skills, agents, and integrations ship constantly. Follow for real-time updates:

Follow on X


AI models can write code. That's not the hard part anymore. The hard part is everything around it - task selection, branch management, code review, artifact cleanup, CI, PR comments, deployment. AgentSys is the runtime that orchestrates agents to handle all of it - structured pipelines, gated phases, specialized agents, and persistent state that survives session boundaries.


Building custom skills, agents, hooks, or MCP tools? agnix is the CLI + LSP linter that catches config errors before they fail silently - real-time IDE validation, auto suggestions, auto-fix, and 423 rules for Claude Code, Codex, OpenCode, Cursor, Kiro, Copilot, Gemini CLI, Cline, Windsurf, Roo Code, Amp, and more.

What's New in 6.0.2

  • Fixes Windows installs: the Claude Code executable is resolved with where.exe instead of an assumed claude.cmd, and .cmd shims are launched through cmd.exe at every spawn site.
  • agentsys install reports failures instead of printing success when Claude Code rejected a plugin, and exits non-zero.
  • Deletes the two adapter install.sh scripts, which deleted a working install and reported success; agentsys --tool codex / --tool opencode is the install path.
  • CI now runs the suite on Windows as well as Linux.

What This Is

An agent orchestration system - 24 plugins, 49 agents (39 file-based + 10 role-based specialists in audit-project), and 44 skills that compose into structured pipelines for software development. Each plugin lives in its own standalone repo under the agent-sh org. agentsys is the marketplace and installer that ties them together.

Each agent has a single responsibility, a specific model assignment, and defined inputs/outputs. Pipelines enforce phase gates so agents can't skip steps. State persists across sessions so work survives interruptions.

The system runs on Claude Code, OpenCode, Codex CLI, Cursor, and Kiro. Install via the marketplace or the npm installer, and the plugins are fetched automatically from their repos.


The Approach

Code does code work. AI does AI work.

  • Detection: regex, AST analysis, static analysis - fast, deterministic, no tokens wasted
  • Judgment: LLM calls for synthesis, planning, review - where reasoning matters
  • Result: 77% fewer tokens for /drift-detect vs multi-agent approaches, certainty-graded findings throughout

Certainty levels exist because not all findings are equal:

Level Meaning Action
HIGH Definitely a problem Safe to auto-fix
MEDIUM Probably a problem Needs context
LOW Might be a problem Needs human judgment

This came from testing on 1,000+ repositories.


Benchmarks

Structured prompts and enriched context do more for output quality than model tier. Benchmarked March 2026 on real tasks (/can-i-help and /onboard against glide-mq), measured with claude -p --output-format json. Models: Claude Opus 4 and Claude Sonnet 4.

Sonnet + AgentSys vs raw Opus

Same task, same repo, same prompt ("I want to improve docs"):

Configuration Cost Output tokens Result quality
Opus, no agentsys $1.10 2,841 Generic recommendations, no project-specific context
Opus + agentsys $1.95 5,879 Specific recommendations with effort estimates, convention awareness, breaking change detection
Sonnet + agentsys $0.66 6,084 Comparable to Opus + agentsys: specific, actionable, project-aware

Sonnet + agentsys produced more output with higher specificity than raw Opus - at 40% lower cost.

With agentsys, model tier matters less

Once the pipeline provides structured prompts, enriched repo-intel data, and phase-gated workflows, the model does less heavy lifting. The gap between Sonnet and Opus narrows:

Plugin Opus Sonnet Savings
/onboard $1.10 $0.30 73%
/can-i-help $1.34 $0.23 83%

Both models reached the same outcome quality - Sonnet just costs less to get there. The structured pipeline captures most of the gains that would otherwise require a more expensive model.

What this means

Scenario Model cost Quality
Without agentsys Need Opus for good results Depends on model capability
With agentsys Sonnet is sufficient Pipeline handles the structure, model handles judgment

The investment shifts from model spend to pipeline design. Better prompts, richer context, enforced phases - these compound in ways that model upgrades alone don't.


Commands

Command What it does
/next-task Task workflow: discovery, implementation, PR, merge
/prepare-delivery Pre-ship quality gates: deslop, review, validation, docs sync
/gate-and-ship Quality gates then ship (/prepare-delivery + /ship)
/banthis Durable negative memory: persist banned agent behaviors
/agnix Lint agent configurations (423 rules)
/ship PR creation, CI monitoring, merge
/deslop Clean AI slop patterns
/perf Performance investigation with baselines and profiling
/drift-detect Compare plan vs implementation
/audit-project Multi-agent iterative code review
/enhance Plugin, agent, and prompt analyzers
/repo-intel Unified static analysis - git history, AST symbols, project metadata
/sync-docs Sync documentation with code changes
/learn Research topics, create learning guides
/consult Cross-tool AI consultation
/debate Structured debate between AI tools
/release Versioned release with ecosystem detection
/skillers Workflow pattern learning and automation
/skill-curator Create and improve reliable SKILL.md files
/system-prompt-curator Create and improve autonomous agent system prompts
/onboard Codebase orientation for newcomers
/can-i-help Match contributor skills to project needs

Each command works standalone. Together, they compose into end-to-end pipelines.


Skills

readme truncated — read the full docs on github

Frequently asked questions

Is agentsys free to use?

agentsys is open source under the MIT licence. There is no licence fee and no seat count — you can self-host it or, where the project offers one, pay a vendor for a managed version instead.

What does agentsys do?

AI writes code. This automates everything else · 24 plugins · 49 agents · 44 skills · for Claude Code, OpenCode, Codex, Cursor, Kiro.

What is agentsys written in?

agentsys is primarily written in JavaScript. Its source is publicly available at https://github.com/agent-sh/agentsys, and it has 986 GitHub stars.