almirant link

Link the current repository to an Almirant project. It uses accounts stored by almirant login, generates a secretless .mcp.json, and copies skill templates.

Usage

almirant link

warning

Requires having run almirant login previously. If no accounts are stored, run almirant init or almirant login first.

What it does

1. Reads accounts from ~/.almirant/config.json.
2. If several exist, lets you choose the account or reuse the active one.
3. Validates that the API key is still valid.
4. Fetches the list of available projects.
5. Lets you select or create a project.
6. Merges the almirant entry into .mcp.json without touching other MCP servers.
7. Copies skills to .claude/skills/ and .agents/skills/.

Secretless .mcp.json

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

The repo is pinned to the stable ID of the selected account, but the API key stays only in ~/.almirant/config.json.

Codex

If your agent uses .codex/config.toml, configure the same proxy:

[mcp_servers.almirant]
command = "almirant"
args = ["mcp", "proxy", "--project-id", "<project-id>", "--account", "<account-id-or-label>"]

Do not write tokens in .codex/config.toml. To follow the active account selected with almirant use, omit --account.