Skip to main content

almirant init

Configure the Almirant MCP integration for the current repository. This is the all-in-one flow: it includes authentication if needed, account selection, project selection, and configuration generation.

Usage​

almirant init [--api-url <url>] [--app-url <url>] [--name <name>]

What it does​

  1. Detects the project type.
  2. Checks if .mcp.json already exists and asks whether to continue and merge the Almirant entry.
  3. Lets you select a stored account or add a new one.
  4. Validates credentials against the server.
  5. Shows available projects to select or create.
  6. Generates .mcp.json using almirant mcp proxy without writing tokens.
  7. Copies skills to .claude/skills/ and .agents/skills/.

Generated .mcp.json​

{
  "mcpServers": {
    "almirant": {
      "type": "stdio",
      "command": "almirant",
      "args": ["mcp", "proxy", "--project-id", "<project-id>", "--account", "<account-id>"]
    }
  }
}

The API key does not appear in the repository. The proxy reads the account from ~/.almirant/config.json and attaches the bearer token in memory only.

  • Use init when this is your first setup on a machine or you want the CLI to guide you through login.
  • Use link when credentials are already stored and you only want to link another repository quickly.