Remote Agents

# Run from GitHub
agentuse run https://raw.githubusercontent.com/user/repo/main/agent.agentuse

# Run from your server
agentuse run https://example.com/agents/helper.agentuse

# Run from Gist
agentuse run https://gist.githubusercontent.com/user/id/raw/agent.agentuse

agentuse run https://example.com/agent.agentuse "Process this data"

⚠️  WARNING: You are about to execute an agent from:
https://example.com/agent.agentuse

Only continue if you trust the source and have audited the agent.
[p]review / [y]es / [N]o: 

my-agents/
├── README.md
├── data-processor.agentuse
├── text-analyzer.agentuse
└── api-caller.agentuse

agentuse run https://raw.githubusercontent.com/username/my-agents/main/data-processor.agentuse

// Express example
app.get('/agents/:name', (req, res) => {
  const agentContent = getAgent(req.params.name);
  res.type('text/plain').send(agentContent);
});

# Specific version
agentuse run https://raw.githubusercontent.com/user/repo/v1.0.0/agent.agentuse

# Latest stable
agentuse run https://raw.githubusercontent.com/user/repo/stable/agent.agentuse

# Development version
agentuse run https://raw.githubusercontent.com/user/repo/dev/agent.agentuse

# Semantic versioning in path
agentuse run https://example.com/agents/v2/processor.agentuse
agentuse run https://example.com/agents/v1/processor.agentuse

// Dynamic agent loader
const agentUrl = process.env.PROD 
  ? 'https://prod.example.com/agent.agentuse'
  : 'https://dev.example.com/agent.agentuse';

execSync(`agentuse run ${agentUrl}`);

---
name: orchestrator
model: anthropic:claude-sonnet-5
subagents:
  - path: https://example.com/agents/analyzer.agentuse
  - path: https://example.com/agents/reporter.agentuse
---

# GitHub Actions
name: Run Remote Agent
on: [push]
jobs:
  agent:
    runs-on: ubuntu-latest
    steps:
      - run: pnpm install -g agentuse
      - run: |
          echo "y" | agentuse run https://example.com/agents/ci-checker.agentuse \
            "Check PR #${{ github.event.pull_request.number }}"

team-agents/
├── README.md
├── daily/
│   ├── standup.agentuse
│   └── report.agentuse
├── development/
│   ├── code-review.agentuse
│   └── test-runner.agentuse
└── deployment/
    ├── pre-deploy.agentuse
    └── post-deploy.agentuse

# Daily standup
agentuse run https://raw.githubusercontent.com/team/agents/main/daily/standup.agentuse

# Code review
agentuse run https://raw.githubusercontent.com/team/agents/main/development/code-review.agentuse

# Deployment  
agentuse run https://raw.githubusercontent.com/team/agents/main/deployment/pre-deploy.agentuse