@geekbeer/minion

AI Agent runtime for Minion - manages heartbeat, status, and skill deployment on VPS.

Install

npm install -g @geekbeer/minion

Usage

Setup (VPS)

minion-cli setup \
  --hq-url https://minion-agent.com \
  --minion-id <MINION_ID> \
  --api-token <API_TOKEN> \
  --setup-tunnel \
  --non-interactive

Service Management

minion-cli start      # Start the minion agent
minion-cli stop       # Stop the minion agent
minion-cli restart    # Restart the minion agent
minion-cli status     # Show service status
minion-cli health     # Run health check

Logging

minion-cli log -m "Task completed" -l info -s skill-name

Issue Reporting

const { reportIssue } = require('@geekbeer/minion/api')

await reportIssue({
  title: 'HQ APIで502エラーが発生する',
  body: '## 状況\n...\n\n## 再現手順\n...',
  labels: ['bug', 'critical']
})
// → { success: true, issue_url: '...', issue_number: 42 }

Environment Variables

| Variable | Description | Default | |----------|-------------|---------| | HQ_URL | Minion HQ server URL | - | | API_TOKEN | Authentication token | - | | MINION_ID | Minion UUID | - | | AGENT_PORT | Agent API listen port | 3001 | | HEARTBEAT_INTERVAL | Heartbeat interval (ms) | 30000 |

License

MIT