Skip to content

akka/akka

v2.9.0Apache-2.0

Complete Akka SDK development workflow — from environment setup to production deployment

Akka AI Marketplace

Plugin marketplace for AI-assisted Akka SDK development.

Installation

Claude Code (plugin)

/plugin marketplace add akka/ai-marketplace
/plugin install akka@ai-marketplace
/reload-plugins
/akka:setup

Antigravity (agy)

agy plugin install https://github.com/akka/ai-marketplace

Codex

Codex can use the same Akka workflow from the plugins/akka directory. That plugin package includes a Codex manifest, an Akka MCP config using akka mcp serve --disable-prompt, and Codex skill aliases for the Akka workflows.

Akka CLI (any AI agent)

If you're using Cursor, Windsurf, VS Code Copilot, or another AI coding agent — or prefer to set up manually — use the Akka CLI:

# Install the Akka CLI (see link above for all platform)
brew install akka/brew/akka      # macOS

# Initialize your project — use the --agent flag for your editor
akka specify init . --agent cursor
akka specify init . --agent vscode-copilot
akka specify init . --agent claude-code

The --agent flag controls where commands are installed:

AgentFlagCommands installed to
Claude Code--agent claude-code.claude/commands/
Cursor--agent cursor.cursor/rules/
VS Code Copilot--agent vscode-copilot.github/prompts/

This produces the same result as the Claude Code plugin: skills, templates, documentation, and MCP server configuration installed in your project directory. For Codex, use the repo-local plugin files under plugins/akka.

Getting Started

After installing via either path, run the setup command in your project directory:

  • Plugin: /akka:setup
  • CLI-installed: /akka.setup

It will:

  1. Detect your OS and install any missing dependencies (Java 21+, Maven 3.9+, Akka CLI)
  2. Configure the Akka download token for Maven
  3. Scaffold a new Akka project (or repair/upgrade an existing one)
  4. Download SDK documentation and AI context
  5. Optionally configure Docker and AI API keys

Zero prerequisites beyond having a supported AI coding agent installed.

Commands

Plugin (Claude Code)CLI-installedDescription
/akka:setup/akka.setupSet up a complete Akka development environment
/akka:constitution/akka.constitutionCreate or update the project constitution
/akka:specify/akka.specifyCreate or update a feature specification
/akka:clarify/akka.clarifyResolve open questions in specs or plans
/akka:plan/akka.planGenerate an implementation plan from a spec
/akka:tasks/akka.tasksBreak a plan into ordered, testable tasks
/akka:analyze/akka.analyzeAnalyze codebase for patterns and issues
/akka:checklist/akka.checklistGenerate implementation or review checklists
/akka:implement/akka.implementExecute tasks from the task list
/akka:harnesses/akka.harnessesGenerate the enterprise-configuration assets required
/akka:converge/akka.convergeQueue remaining work the spec and plan still require
/akka:review/akka.reviewReview code against spec and constitution
/akka:build/akka.buildBuild, test, and run the service locally
/akka:inspect/akka.inspectInspect a deployed service
/akka:reliability/akka.reliabilityAdd or remove resilience-testing instrumentation
/akka:deploy/akka.deployDeploy to the Akka platform
/akka:issues/akka.issuesTrack and manage issues
/akka:status/akka.statusShow the definition-of-done rollup, read-only
/akka:conform/akka.conformRun the auditors and return the ship-readiness verdict
/akka:ship/akka.shipRun the auditors and, on pass, run the ship steps
/akka:mode/akka.modeSwitch between Enforced and À la carte modes
/akka:docs/akka.docsGenerate rendered project documentation into docs/

Migrating from akka-specify? The akka-specify plugin is still available but deprecated. Uninstall it and install akka instead.

Attribution

The spec-driven development workflow (specify, plan, tasks, clarify, analyze, checklist, issues) is built on SpecKit, adapted for the Akka SDK with MCP tool integration. The build, conform, constitution, converge, deploy, docs, harnesses, implement, inspect, mode, reliability, review, setup, ship, and status skills are original to Akka.

License

See LICENSE for details.