run-agent

# Run Agents ## When to Use When a user wants to run an agent locally, from a git repo, or with a specific adapter/framework. ## Troubleshooting If you see authentication errors: - **Claude**: Ensure Claude Code is authenticated (`claude auth status`) - **OpenAI**: Verify `OPENAI_API_KEY` is set and valid - **GitHub**: Check `GITHUB_TOKEN` has correct permissions - **Lyzr**: Confirm `LYZR_API_KEY` is active ## Basic Usage ```bash # Run local agent with Claude (default) gitagent run -d ./my-agent # Run from git repo gitagent run -r https://github.com/user/agent # Run with a prompt (one-shot mode) gitagent run -d ./my-agent -p "Review my code" ``` ## Adapters | Adapter | Flag | Env Var Required | Interactive | |---------|------|-----------------|-------------| | Claude | `-a claude` | *(uses Claude Code auth)* | Yes | | OpenAI | `-a openai` | `OPENAI_API_KEY` | No | | CrewAI | `-a crewai` | — | No | | OpenClaw | `-a openclaw` | `ANTHROPIC_API_KEY` | No (`-p` required) | | Nanobot | `-a nanobot` | `ANTHROPIC_API_KEY` | Yes | | Lyzr | `-a lyzr` | `LYZR_API_KEY` | No (`-p` required) | | GitHub | `-a github` | `GITHUB_TOKEN` | No (`-p` required) | | Git | `-a git` | *(auto-detects)* | Depends | | Prompt | `-a prompt` | — | Print only | ## Examples ```bash # Claude (interactive) gitagent run -d ./my-agent # GitHub Models (one-shot, streaming) export GITHUB_TOKEN="ghp_..." gitagent run -d ./my-agent -a github -p "Explain this codebase" # Lyzr (creates agent on Lyzr Studi...