// Configures and runs agents with different adapters including Claude, OpenAI, CrewAI, Lyzr, and GitHub Models. Supports local execution, remote git repos, and one-shot prompts. Use when the user wants to run an agent, switch LLM providers, configure adapter settings, or launch agents from git repositories.
| name | run-agent |
| description | Configures and runs agents with different adapters including Claude, OpenAI, CrewAI, Lyzr, and GitHub Models. Supports local execution, remote git repos, and one-shot prompts. Use when the user wants to run an agent, switch LLM providers, configure adapter settings, or launch agents from git repositories. |
| license | MIT |
| metadata | {"author":"gitagent","version":"1.0.0","category":"execution"} |
When a user wants to run an agent locally, from a git repo, or with a specific adapter/framework.
If you see authentication errors:
claude auth status)OPENAI_API_KEY is set and validGITHUB_TOKEN has correct permissionsLYZR_API_KEY is active# 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"
| 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 |
# Claude (interactive)
opengap run -d ./my-agent
# GitHub Models (one-shot, streaming)
export GITHUB_TOKEN="ghp_..."
opengap run -d ./my-agent -a github -p "Explain this codebase"
# Lyzr (creates agent on Lyzr Studio + chats)
export LYZR_API_KEY="..."
opengap run -r https://github.com/user/agent -a lyzr -p "Hello"
# Lyzr one-liner (clone + create + chat)
opengap lyzr run -r https://github.com/user/agent -p "Hello"
# Auto-detect adapter from repo
opengap run -r https://github.com/user/agent -a git -p "Hello"
# Just print the system prompt
opengap run -d ./my-agent -a prompt
Repos cloned via -r are cached at ~/.gitagent/cache/:
# Use cache (default)
opengap run -r https://github.com/user/agent
# Force refresh
opengap run -r https://github.com/user/agent --refresh
# No cache (temp dir, deleted after)
opengap run -r https://github.com/user/agent --no-cache
-a git)The git adapter detects the best runner from the repo:
.gitagent_adapter file (explicit hint)Creates and configures agent.yaml files, writes SOUL.md personality definitions, and sets up agent directory structures with skills, tools, and knowledge. Use when the user wants to configure an agent, create agent.yaml, write SOUL.md, set up agent directory structure, or customize agent settings.
Converts agent definitions between frameworks — exports to Claude Code, OpenAI, CrewAI, Lyzr, and GitHub Models formats, and imports from Claude, Cursor, and CrewAI projects. Use when the user wants to convert an agent, migrate to another framework, export to LangChain/AutoGen/CrewAI, or import from existing automation tools.
Guides installation of gitagent and creation of first agent with scaffolding, configuration, and validation. Use when the user is new to gitagent, asks how to get started, wants to install gitagent, set up their first agent, or says 'how do I start?'
Searches the SkillsMP registry, installs skills locally or globally, creates custom skills with SKILL.md frontmatter, and manages the skill lifecycle. Use when the user wants to find skills, add new capabilities, install a skill, browse available skills, create a custom skill, or manage the skills system.
Model selection by provider health, not task complexity. Tier 0 (local) handles most tasks. Paid models are break-glass only. Fallbacks activate on 429 or timeout — never on perceived task difficulty.
Memory integrity audit. Detects hallucinations, circular confirmations, and state poisoning. Runs automatically after 2 consecutive failures or at nightly deep dive. Uses Opus 4.6 as the auditor model.