Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (agentuse) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

AI Agents on Autopilot

Define in markdown. Run on cron, CI/CD, or Docker.
No SDK. No flowcharts. Just AI agents that run themselves.

Quick Start • Example • Documentation

Quick Start

# Try it now - no install needed
ANTHROPIC_API_KEY=sk-ant-... npx agentuse@latest run https://agentuse.io/hello.agentuse

Create my-agent.agentuse:

---
model: anthropic:claude-sonnet-4-5
---

Generate a daily motivation quote with a tech fact.
Format as JSON with 'quote' and 'fact' fields.

Run it:

agentuse run my-agent.agentuse

Example

A real-world agent with MCP tools:

---
model: anthropic:claude-sonnet-4-5
mcpServers:
  postgres:
    command: npx
    args: ["-y", "@modelcontextprotocol/server-postgres"]
    requiredEnvVars: [DATABASE_URL]
---

Query the sales table for yesterday's metrics.
Generate an executive summary with trends.

Schedule with cron, run in CI/CD, or deploy to Docker.

Features

📝 Markdown-Based Agents

Define agents as .agentuse files with YAML frontmatter and plain English instructions. Version control, code review, and collaborate on agents like any other code.

🔌 MCP Integration

Connect to any Model Context Protocol server. Access databases, APIs, file systems, and external services through a standardized tool interface.

🤖 Multi-Provider Support

Works with Anthropic (Claude), OpenAI (GPT), and OpenRouter for open source models like GLM and Minimax. Switch models with a single line change.

🎭 Sub-Agents

Compose complex workflows by delegating tasks to specialized child agents. Parent agents can spawn sub-agents with isolated contexts and step limits.

⚡ Skills System

Create reusable agent instructions as SKILL.md files. Reuse your existing Claude Code skills directly - AgentUse reads from the same .claude/skills/ directories. List available skills with agentuse skills.

🌐 HTTP API

Run agents programmatically via REST endpoint. Supports JSON responses and NDJSON streaming for real-time output.

📊 Session Tracking

Full execution history with message logs, tool call traces, token usage, and timing metrics. Debug and audit agent runs with agentuse sessions.

Install

npm install -g agentuse

Set your API key:

export ANTHROPIC_API_KEY="sk-ant-..."
# or
export OPENAI_API_KEY="sk-..."
# or
export OPENROUTER_API_KEY="sk-or-..."

JSPM

agentuse