Documentation
README
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_KEYis set and valid - GitHub: Check
GITHUB_TOKENhas correct permissions - Lyzr: Confirm
LYZR_API_KEYis active
Basic Usage
# Run local agent with Claude (default)
opengap run -d ./my-agent
# Run from git repo
opengap run -r https://github.com/user/agent
# Run with a prompt (one-shot mode)
opengap run -d ./my-agent -p "Review my code"
Adapters
This is the opening of the README. Read the full README on GitHub.