akka specify init

Initialize a new Akka project for AI-assisted development.

Synopsis

Initialize a project with everything needed for AI-assisted Akka development. This command:

  1. Verifies Maven is configured with the Akka resolver (prompts for setup if needed)

  2. Clones an Akka sample project (or uses the current directory with '.')

  3. Downloads the Akka SDK constitution

  4. Installs slash commands, templates, and project constitution

  5. Configures the MCP server for AI agent integration

The Akka resolver is required to download Akka SDK dependencies. If your Maven settings.xml is not configured, this command will open a browser to log in to your free Akka support account and provision a resolver token.

The cloned repository includes CLAUDE.md, AGENTS.md, and Akka AI context files that are version-synchronized with the SDK.

After running this command, open Claude Code (or your preferred AI agent) in the project directory to start developing.

Examples: akka specify init my-service # clone sample into new directory cd my-service && claude

akka specify init . # install resources in current directory claude

akka specify init [name] [flags]

Options

      --agent string   AI agent to configure (claude-code, cursor, generic). (default "claude-code")
  -h, --help           help for init

Options inherited from parent commands

      --cache-file string   location of cache file (default "~/.akka/cache.yaml")
      --config string       location of config file (default "~/.akka/config.yaml")
      --context string      configuration context to use
      --disable-prompt      Disable all interactive prompts when running akka commands. If input is required, defaults will be used, or an error will be raised.
                            This is equivalent to setting the environment variable AKKA_DISABLE_PROMPTS to true.
  -o, --output string       set output format to one of [text,json,json-compact,go-template=] (default "text")
      --page-mode string    the mode for paging, either paged, buffered or auto. (default "auto")
  -q, --quiet               set quiet output (helpful when used as part of a script)
      --timeout duration    client command timeout (default 10s)
      --use-grpc-web        use grpc-web when talking to Akka APIs. This is useful when behind corporate firewalls that decrypt traffic but don't support HTTP/2.
  -v, --verbose             set verbose output

SEE ALSO

  • akka specify - Initialize and manage AI-assisted Akka development projects.