Agora — Instant OpenCode Setup & Marketplace

One command from zero to a perfectly configured OpenCode environment.

Project scanner, MCP marketplace, workflow manager, and community hub — all in one CLI.

Demo

A terminal recording is in the works — see ROADMAP.md.

What is Agora?

Agora is a zero-config OpenCode setup tool and terminal marketplace. Run npx opencode-agora init in any project and it automatically scans your stack, generates the perfect opencode.json, installs MCP servers, and registers the plugin.

It also bundles 36+ MCP servers, 10 production workflows, 6 tutorials, and a full community discussion system — all usable offline.

Features

agora init — One-Command Setup

• Scans your project for package.json, Cargo.toml, pyproject.toml, go.mod, Gemfile, Dockerfile, and more
• Detects frameworks (React, Next.js, Django, Rails, Spring, Vue)
• Generates the optimal opencode.json with stack-matched MCP servers
• Automatically installs npm packages and registers the opencode-agora plugin
• Ready in seconds — run once, done

agora use — Apply Workflows as Skills

• Browse 10+ production-tested workflows (TDD, security audit, API design, refactoring, etc.)
• agora use wf-tdd-cycle creates an OpenCode skill file and registers it
• No manual copy-pasting — one command and the workflow is live

Rich Offline Marketplace

• 36+ MCP servers across 12 categories (filesystem, databases, cloud, browser automation, monitoring, etc.)
• All official @modelcontextprotocol/* servers plus top community servers
• Fully functional offline — no backend required
• Search, browse, trending — all work with bundled data

Config-Aware Installs

• agora install mcp-github --write installs the npm package and writes to config
• Detects OpenCode config path automatically
• Merge MCP servers into existing config
• Inspect config health with agora config doctor

Community

• Discussion threads on tools and patterns
• Trending prompts and workflows
• Browse and create discussions from the terminal

OpenCode Plugin

• Search, browse, install-preview, review, profile, discussion, and tutorial tools from inside OpenCode
• Uses the same marketplace core as the CLI

Local Hub

• Optional browser console for browsing the marketplace
• Runs locally with bun run hub:dev

Learn

• 6 interactive tutorials on MCP, OpenCode agents, security auditing, and more

Quick Start

The fastest way to get started — works in any project directory:

# One command: scan project, set up OpenCode, install MCP servers, register plugin
npx opencode-agora init

For a persistent command:

npm install -g opencode-agora
agora init

Install from source

Until the package is published to npm, or if you prefer to run from source:

git clone https://github.com/IrgenSlj/agora.git && cd agora && bun install && bun run build && bun link

The package exposes two binary names:

agora --help
opencode-agora --help

Live mode / hosted backend

Note: Browse, search, and all read-only commands work fully offline using bundled data — no backend required. Features that write data (publish, reviews, discussions, auth login) and the --api flag require a live backend. A hosted instance is not yet deployed. Until then, self-host via the backend/ directory and set AGORA_API_URL to your instance URL before using --api or any write commands.

Usage

Setup

# Scan project and generate optimal OpenCode config
agora init
agora init --dry-run    # Preview without writing

# Apply a workflow as an OpenCode skill
agora use wf-tdd-cycle
agora use wf-security-audit

Marketplace

# Search and browse
agora search filesystem
agora search database --category mcp
AGORA_API_URL=https://agora.example.com agora search github --api
agora browse mcp-postgres
agora trending

# Install MCP servers
agora install mcp-github           # preview only
agora install mcp-github --write   # install npm package + write config

# Save/bookmark items
agora save wf-security-audit
agora saved
agora remove wf-security-audit

Workflows

agora workflows
agora workflows security

Community & Auth

agora discussions mcp --category question
agora discuss --title "MCP question" --content "How are you composing servers?" --category question
agora auth login --token $AGORA_TOKEN --api-url https://agora.example.com
agora auth status
agora publish package --name @you/server --description "MCP server" --npm @you/server
agora publish workflow --name "Security Audit" --description "Audit workflow" --prompt-file ./prompt.md
agora review mcp-github --rating 5 --content "Works well"
agora reviews mcp-github --api
agora profile alice

Diagnostics

agora config doctor
agora config doctor --json

agora install <id> is preview-only by default. Add --write to install the npm package and update config. Pass --config ./opencode.json for an explicit target.

Saved items and optional auth credentials are stored in ~/.config/agora/state.json by default. Use AGORA_HOME=/path/to/agora or --data-dir /path/to/agora to override.

The CLI uses bundled offline marketplace data (36+ MCP servers, 10 workflows) by default. Add --api, --live, AGORA_USE_API=true, or AGORA_API_URL to use the live backend. Falls back to offline data if the API is unavailable.

OpenCode Plugin Commands

Once registered (via agora init or manually), use inside OpenCode:

Categories: mcp, prompt, workflow, skill | Data sources: offline (default), --api

Registering the plugin manually

If you did not run agora init, register the plugin by hand:

1. Install the package globally:

   npm install -g opencode-agora

2. Add "opencode-agora" to the plugins array in ~/.config/opencode/opencode.json (or your project-local opencode.json):

   {
     "plugins": ["opencode-agora"]
   }

Development

# Typecheck
bun run typecheck

# Build package output
bun run build

# Run tests
bun test

# Try the CLI from source
bun src/cli.ts search filesystem

# Install locally to OpenCode
bun run dev

# Run the optional local Hub
bun run hub:dev

Project Structure

agora/
├── src/              # CLI, plugin, and shared marketplace core
├── backend/          # Cloudflare Workers API
├── hub/              # Optional local web Hub
├── test/             # Tests
├── dist/             # Built output
└── README.md

Architecture

agora/
├── src/
│   ├── cli.ts        # CLI entrypoint
│   ├── cli/app.ts    # CLI command parser and handlers
│   ├── init.ts       # Project scanner + init plan generator
│   ├── live.ts       # Live API source with offline fallback
│   ├── marketplace.ts # Shared search, browse, trending, install-plan core
│   ├── config-files.ts # OpenCode config detection, doctor, and write helpers
│   ├── state.ts      # Local Agora saved-item state
│   ├── index.ts      # OpenCode plugin
│   ├── api.ts        # API client with fallback
│   ├── format.ts     # Output formatting
│   ├── config.ts     # MCP config generation
│   ├── data.ts       # 36+ MCP servers, 10 workflows, 6 tutorials
│   └── types.ts      # TypeScript types
│
├── backend/          # Cloudflare Workers API
│   ├── src/index.ts  # Hono server + routes
│   ├── schema.sql    # D1 database schema
│   └── services/      # npm + GitHub API clients
│
├── hub/              # Local Hub app
│
├── test/             # Unit and CLI tests
└── dist/             # Built output

Project Status

Testing

bun test

Roadmap

See ROADMAP.md for upcoming work and ways to contribute.

License

MIT

Built for the developer community