run-agent
Launch agents with flexible LLM provider selection across Claude, OpenAI, CrewAI, Lyzr, GitHub Models, and other adapters. Supports local directories, remote git repositories, and one-shot prompts for immediate execution. Auto-detection identifies the best adapter from your repo's configuration.
run-agent executes local or remote agents with your choice of LLM adapter, from Claude to GitHub Models.
AI-generated summary based on this skill's SKILL.md
Install
open-gitagent/opengap/run-agent · repository language: TypeScript
git clone https://github.com/open-gitagent/opengap
cp -r opengap/examples/gitagent-helper/skills/run-agent ~/.claude/skills/run-agentFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
How to run an agent locally with run-agent?
run-agent launches agents from your local directory by auto-detecting the best LLM adapter from your repository's configuration. Simply point it to your agent folder, and it identifies whether you're using Claude, OpenAI, CrewAI, Lyzr, GitHub Models, or another supported framework, then executes it with the appropriate adapter settings.
Can I execute an agent with a specific LLM adapter?
Yes. run-agent lets you specify which LLM adapter to use—Claude, OpenAI, CrewAI, Lyzr, GitHub Models, and others are supported. You can configure your preferred adapter in the agent's settings, and run-agent will execute using that exact framework for consistent behavior across runs.
How do I run an agent from a GitHub repository?
run-agent supports launching agents directly from remote git repositories. Provide the repository URL, and run-agent clones and configures the agent from that source. This works for both local setup and immediate execution, letting you run agents hosted anywhere without manual cloning.
What's the best way to switch LLM providers for agent execution?
run-agent makes provider switching seamless by letting you select different LLM adapters—Claude, OpenAI, CrewAI, Lyzr, GitHub Models, and more. Change your adapter configuration or specify it at runtime, and run-agent handles the switch automatically without rewriting your agent code.
Can run-agent execute an agent with just one prompt?
Yes. run-agent supports one-shot mode, letting you execute agents with a single prompt for immediate results. This is ideal for quick testing, prototyping, or running agents without complex multi-turn setup—just provide your prompt and run-agent handles the rest.
How does run-agent auto-detect the right adapter?
run-agent scans your repository's configuration files to identify which framework and LLM adapter your agent uses. It recognizes Claude, OpenAI, CrewAI, Lyzr, GitHub Models, and other supported adapters, then automatically applies the correct settings for seamless execution without manual configuration.
SKILL.md
rendered from the published skill — quoted content, verbatim
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
# 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
| Adapter | Flag | Env Var Required | Interactive
(truncated - see the full file via the links below)
Read as markdown · JSON record · Browse the source repository
File tree — 1 file
examples/gitagent-helper/skills/run-agent/SKILL.md