Skip to main content
A new machine needs only this repository, a few logins and the commands below. Nothing else is assumed.

Steps

  1. Clone figentra/stackra and cd into it.
  2. Toolchain: mise trust && mise install. mise.toml pins Node, pnpm, gitleaks, the Infisical CLI, uv and Maestro, and sets AWS_PROFILE=bedrock.
  3. Dependencies: pnpm install.
  4. Tools mise does not pin (no mise backend carries them): OpenCode v2 (https://opencode.ai/install), the Claude Code CLI, the AWS CLI (brew install awscli) and, once a service adopts it, Encore (brew install encoredev/tap/encore). Maestro also needs a JDK on PATH.
  5. Logins:
    • infisical login (the project config is the committed .infisical.yaml).
    • Add a bedrock profile to ~/.aws/config, then aws sso login --profile bedrock. OpenCode reaches Kimi K3 on Amazon Bedrock through it.
    • Sign in to Claude Code.
  6. MCP servers: pnpm agents:sync renders .mcp.json from the committed .mcp.yaml. Tokens come from Infisical through tools/scripts/mcp.sh, never from a file.
  7. Check: pnpm doctor.

What pnpm doctor checks

Doctor prints a ✔ / ✖ / ! line per check with the fix beneath each failure, and exits 1 if any required check fails. It runs only non-secret status commands and never prints a value. Delegating work to OpenCode afterwards: pnpm delegate <task-type> "<brief>" (routing in .agents/routing.yaml) and pnpm ai:spend for the daily cap. Both land with their own pull request.