Skip to content

agentuse/agentuse

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

239 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

AgentUse Logo

Autonomous Agents That Work Without You

NPM Version NPM Downloads GitHub Stars License

Any model. Works with Claude, GPT, and open-source models.
Run anywhere. Webhooks, built-in cron, CI/CD, Mac, Linux, Windows or Docker.
No SDK required. Define your agent in Markdown.

Quick Start β€’ Example β€’ Deploy β€’ 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.

Deploy

Webhook Server - Trigger agents via HTTP:

agentuse serve
curl -X POST http://localhost:12233/run -d '{"agent": "my-agent"}'

Scheduled Agents - Run on a schedule:

---
schedule: "0 9 * * *"
---

Features

πŸ€– 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.

🌐 Webhooks & HTTP API

Trigger agents via HTTP webhooks. Integrate with Zapier, Make, GitHub Actions, or any system that can POST. Supports streaming responses for real-time output.

⏰ Cron Scheduling

Schedule agents to run automatically with built-in cron support. Use intervals for sub-daily (5m, 2h) or cron expressions for daily+ (0 9 * * *).

πŸ“ 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.

🎭 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.

πŸ“Š 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:

agentuse auth login

Documentation

Full guides and API reference at docs.agentuse.io

Contributing

License

Apache 2.0

About

πŸ€– AI agents on autopilot. Any model. Runs local, cron, CI/CD, or Docker.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •  

Languages