ajshedivy/agno-cookbook/agentos-api-agents
Claude Code and agent skill by ajshedivy/agno-cookbook
- community
Checking that the SKILL.md file is still in the repository.
Interact with AgentOS Agent API endpoints. For standard operations (listing agents, running agents, streaming), use the provided CLI script first. Only write custom Python when the script cannot handle the use case (e.g., structured output, dependencies, cancellation, chaining multiple calls). Trigger when: running agents remotely, listing agents, creating agent tests, or asking things like "kick off a run in my test agent" or "what agents do I have configured?"
Install
npx vskill@latest install ajshedivy/agno-cookbook/agentos-api-agentsSKILL.md
The same SKILL.md was published earlier as ajshedivy/agno-cookbook/agentos-api-agents.
AgentOS Agents API
Prerequisites
Start an AgentOS server first:
Default: Use the CLI Script
Always try the provided script first. It covers listing agents, running agents (streaming and non-streaming), session persistence, and dependencies — all from the command line with no custom code needed.
The script is at: scripts/run_agents.py
List all agents
Show full AgentOS config
Show agent-specific config (tools, model, knowledge, memory)
Run an agent with a message
Stream a response
Persistent sessions
Pass dependencies to agent tools
Full CLI reference
When to Write Custom Python
Only write ad-hoc Python when the CLI script cannot handle your use case:
- Structured output (passing a JSON schema)
- Cancel or continue a running agent
- Chaining multiple agent calls in a single script
- Custom error handling or retry logic
- Programmatic inspection of agent config beyond what
--configshows - Integration tests that assert on response content
API Endpoints
| Method | Path | Description | |
|---|---|---|---|
| GET | /agents | List all agents | |
| GET | /agents/{agent_id} | Get agent details | |
| POST | /agents/{agent_id}/runs | Create agent run | |
| POST | /agents/{agent_id}/cancel_run | Cancel agent run | |
| POST | /agents/{agent_id}/continue_run | Continue agent run (resume with tool results) |
Custom Python Examples
Get Agent Details
Run Agent with Structured Output
Cancel Agent Run
Continue Agent Run
Resume a paused execution (e.g., after human-in-the-loop tool approval):
Authentication
When the AgentOS instance has a security key configured:
Error Handling
Anti-Patterns
- Don't write custom Python for basic list/run operations — use the CLI script
- Don't forget `await` — all client methods are async
- Don't hardcode agent IDs — discover them from
aget_config()or the CLI script - Don't skip discovery — always call
aget_config()first to verify agents exist - Don't forget the server — start AgentOS before running client code
- Don't ignore streaming events — always handle both
RunContentEventandRunCompletedEvent
Further Reading
For advanced agent API patterns, read references/api-patterns.md.
Security
- Security scanPassed, 90 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingplugins/agno-agentos-api/skills/agentos-api-agents/SKILL.md
Popularity
- 7-day trend score
- 0
Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/ajshedivy/agno-cookbook/agentos-api-agents)