Quick Start

pnpm install -g agentuse

agentuse auth login

anthropic:claude-sonnet-5
openai:gpt-5.5
openrouter:minimax/minimax-m3
opencode-go:kimi-k2.7-code
bedrock:us.anthropic.claude-sonnet-4-5-20250929-v1:0

---
model: anthropic:claude-haiku-4-5
description: "Simple greeting agent that welcomes users"
---

Greet the user.

agentuse run hello.agentuse

# Or run with additional instructions
agentuse run hello.agentuse "speak like a pirate"

# Run with options
agentuse run hello.agentuse --verbose
agentuse run hello.agentuse --quiet
agentuse run hello.agentuse --no-tty
agentuse run hello.agentuse --timeout 600

# Override the model at runtime
agentuse run hello.agentuse --model openai:gpt-5.4-mini
agentuse run hello.agentuse -m anthropic:claude-sonnet-5

---
model: anthropic:claude-haiku-4-5
description: "Analyzes project structure and identifies key components"
mcpServers:
  filesystem:
    command: "npx"
    args: ["-y", "@modelcontextprotocol/server-filesystem", "."]
---

You are a code analyzer. When asked about a project:
1. List the main files and folders
2. Identify the project type (Node.js, Python, etc.)
3. Summarize what the project does based on README or package.json

agentuse run project-analyzer.agentuse

agentuse run analyzer.agentuse --model anthropic:claude-sonnet-5
agentuse run analyzer.agentuse -m openai:gpt-5.4-mini

---
model: anthropic:claude-haiku-4-5
description: "Orchestrates tasks by delegating to specialized sub-agents"
subagents:
  - path: "./helper-agent.agentuse"
    name: "helper"
    maxSteps: 50
---

You can call the helper agent using the sub-agent tools.

# Run from trusted sources (agentuse.io) without prompts
agentuse run https://agentuse.io/hello.agentuse

# Other URLs will prompt for confirmation
agentuse run https://example.com/path/to/agent.agentuse

# Preview the agent content first
# Choose 'p' when prompted to preview before execution

export ANTHROPIC_API_KEY="sk-ant-..."
export OPENAI_API_KEY="sk-proj-..."

---
model: anthropic:claude-sonnet-5
schedule: "1h"    # Or cron: "0 * * * *"
---

Check system status and send a summary report.

agentuse serve