agestra

Agestra

Multi-host MCP orchestration for Claude Code, Codex CLI, Gemini CLI, and local models.

English | 한국어 | 日本語 | 中文

Agestra helps you use more than one AI to examine the same problem. It is built for review, QA, security checks, design discussion, idea exploration, and evidence-backed consensus.

Quick Start

Install Agestra in the host you already use.

Host	Install
Claude Code	/plugin marketplace add mua-vtuber/Agestra then /plugin install agestra@agestra
Codex CLI	npm install -g agestra then agestra-install codex --assets --scope user
Gemini CLI	npm install -g agestra then agestra-install gemini --assets --scope user

Then open your project and ask for an Agestra workflow.

• Claude Code: /agestra research ... or /agestra review ...
• Gemini CLI: /agestra:research ... or /agestra:review ...
• Codex CLI: ask explicitly for Agestra or multiple providers, for example Use Agestra with Gemini and Codex to review this branch.

The first workflow may ask which providers you want to use. Agestra works best with two or more providers, but setup and host-owned flows still work with one.

What To Use It For

• research: host-only evidence gathering for idea, QA, or security questions. External providers do not investigate in this flow.
• review: debate and compare opinions about existing code, docs, diffs, or prepared research. Review does not start a fresh investigation.
• Review lenses can cover code quality, regressions, UX, cleanup, design fit, performance, reliability, tests, safety smells, and production readiness.

How It Runs

• Agestra checks setup and available providers.
• It turns your request into a clear workflow with a target and scope.
• In research, the current host gathers, organizes, and documents evidence. There is no provider fan-out.
• In review, selected providers discuss the code, documents, diffs, or prepared research already in scope. They do not perform separate research.
• Agestra returns one result with conclusions, disagreements, and evidence.

Plain review or QA requests do not automatically become Agestra workflows. Agestra starts when you use /agestra ... or explicitly ask for multi-AI or provider-backed research/review work.

For code changes, use your current host directly first. Agestra is strongest after that: reviewing the result, checking it against a plan, comparing provider opinions, and recording the evidence.

Using This Repository

If you cloned this repository and want to test the local checkout:

npm install
npm run bundle

Then install for the host you want to use:

npm run install:claude
npm run install:codex
npm run install:gemini

These commands register this checkout and install helper assets. They do not install the package globally.

If you want this checkout to behave like a real global package:

npm run bundle
npm install -g .
npm run install:codex:global

Use npm run install:gemini:global for Gemini.

More Docs

• commands/: workflow source of truth

Development

npm run build
npm test
npm run bundle
npm run lint

Uninstall

Claude Code:

/plugin uninstall agestra@agestra

Codex CLI:

npm run uninstall:codex
npm run uninstall:codex:assets

Gemini CLI:

npm run uninstall:gemini
npm run uninstall:gemini:assets

To remove generated project data too, delete .agestra/ manually.

License

GPL-3.0