Anakin Setup

Check if the Anakin CLI is installed and authenticated. Fix any issues found.

Step 1: Check installation

Run:

anakin status

If the command is not found, install it:

pip install anakin-cli

If pip is not available, try pip3 install anakin-cli or python -m pip install anakin-cli.

After installing, verify with anakin status.

Step 2: Check authentication

If anakin status shows "No API key configured", ask the user how they'd like to authenticate using AskUserQuestion:

Question: "How would you like to authenticate with Anakin?"

Options:

1. Enter API key (Recommended) — Paste an API key from anakin.io/dashboard
2. Set environment variable — Export ANAKIN_API_KEY in your shell

If user selects API key:

Ask for their API key, then run:

anakin login --api-key "<their-key>"

If user selects environment variable:

Ask for their API key, then run:

export ANAKIN_API_KEY="<their-key>"

Tell them to add this export to ~/.zshrc or ~/.bashrc for persistence.

Step 3: Verify

Run anakin status again to confirm everything works. Report the version and auth status to the user.

Step 4: Setup output directory

Create the .anakin/ output directory and ensure it's in .gitignore:

mkdir -p .anakin

If a .gitignore file exists and doesn't already contain .anakin/, add it:

echo ".anakin/" >> .gitignore

Troubleshooting

Command not found

1. Ensure your Python scripts directory is on PATH
2. Try: python -m anakin_cli status
3. Or reinstall: pip install anakin-cli

Permission errors

pip install --user anakin-cli
# or
python -m venv .venv && source .venv/bin/activate && pip install anakin-cli

Authentication failed (401)

Your API key is invalid or expired. Get a new one at https://anakin.io/dashboard.

Plan upgrade required (402)

Visit https://anakin.io/pricing.

Rate limit exceeded (429)

Wait 5-10 seconds and retry.