hermes-agent-mission-control

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Hermes Agent Mission Control

Skill by ara.so — Hermes Skills collection

Minions is a mission control interface for Hermes Agent that provides a Kanban board to create, supervise, and review autonomous work. It solves the problem of juggling multiple terminal sessions and losing track of long-running tasks by providing a visual board with task status (in progress, in review, done), live streaming of agent work, and human-in-the-loop verification.

由ara.so开发的Skill — Hermes Skills合集

Minions 是一款面向Hermes Agent的任务控制界面，提供看板功能来创建、监控和审核自主工作。它通过提供带有任务状态（进行中、审核中、已完成）的可视化面板、Agent工作的实时流以及人机协作验证，解决了需要同时处理多个终端会话并容易丢失长期运行任务跟踪的问题。

Installation

安装

Prerequisites: Node.js 18+ and Hermes Agent

Quick start with npx (no installation required):

bash

npx minionsai

Or install globally:

bash

npm install -g minionsai

Then run:

bash

minions

The server starts on

http://localhost:6969

by default.

前置要求： Node.js 18+ 和 Hermes Agent

使用npx快速启动（无需安装）：

bash

npx minionsai

或全局安装：

bash

npm install -g minionsai

然后运行：

bash

minions

服务器默认启动在

http://localhost:6969

。

Data Storage

数据存储

Minions creates a local SQLite database on first run:

Database and state stored in
```
~/.minions/
```
Chat transcripts live in Hermes's session database
Task metadata, status, and settings stored in Minions SQLite DB
Completely local-first by default (no cloud dependency)

Minions在首次运行时会创建一个本地SQLite数据库：

数据库和状态存储在
```
~/.minions/
```
聊天记录存储在Hermes的会话数据库中
任务元数据、状态和设置存储在Minions的SQLite数据库中
默认完全本地优先（无云依赖）

CLI Commands

CLI命令

bash

undefined

bash

undefined

Start the server

启动服务器

minions

Check version

查看版本

minions --version

Compare with latest NPM version

对比最新NPM版本

npm view minionsai version

undefined

npm view minionsai version

undefined

Key Features & Usage

核心功能与使用方法

Task Management

任务管理

Each task in Minions is a persistent Hermes root session:

Create tasks: Describe what you want in chat
Autonomous execution: Agent decides how to get it done
Live streaming: Watch tool calls, reasoning, and responses in real-time
Completion judge: Lightweight LLM evaluates whether task is done after each turn
Human verification: Review agent's proposed completion before moving to "Done"

Minions中的每个任务都是一个持久化的Hermes根会话：

创建任务：在聊天中描述你的需求
自主执行：Agent决定完成任务的方式
实时流：实时查看工具调用、推理过程和响应
完成判断：轻量级LLM在每一轮交互后评估任务是否完成
人工验证：在标记为“已完成”前，审核Agent提交的任务完成结果

Kanban Board States

看板状态

In Progress: Tasks actively being worked on
In Review: Tasks completed by agent, awaiting human verification
Done: Verified and closed tasks

进行中：正在处理的任务
审核中：Agent已完成工作，等待人工验证
已完成：已验证并关闭的任务

Per-Task Configuration

单任务配置

Override model and reasoning settings on individual tasks:

typescript

// Task metadata structure
interface Task {
  id: string;
  title: string;
  description: string;
  status: 'in_progress' | 'in_review' | 'done';
  sessionId: string; // Hermes session ID
  model?: string; // Override default model
  reasoningEffort?: number; // Override reasoning effort
  createdAt: string;
  updatedAt: string;
}

可以为单个任务覆盖模型和推理设置：

typescript

// 任务元数据结构
interface Task {
  id: string;
  title: string;
  description: string;
  status: 'in_progress' | 'in_review' | 'done';
  sessionId: string; // Hermes会话ID
  model?: string; // 覆盖默认模型
  reasoningEffort?: number; // 覆盖推理强度
  createdAt: string;
  updatedAt: string;
}

Routines

例行程序

Create and manage recurring Hermes jobs:

Schedule regular agent tasks
Track execution history
Review output from each run
Useful for monitoring, data collection, reporting

创建并管理周期性Hermes任务：

定期调度Agent任务
跟踪执行历史
审核每次运行的输出
适用于监控、数据收集、报告场景

File Browser

文件浏览器

View files created by agents in the workspace directory without leaving the interface.

无需离开界面，即可查看Agent在工作目录中创建的文件。

Configuration

配置

Check settings in the web UI Settings page:

View running Minions server version
Configure Hermes Agent connection
Set default model and reasoning effort
Manage workspace directory path

在Web UI的设置页面中查看配置：

查看运行中的Minions服务器版本
配置Hermes Agent连接
设置默认模型和推理强度
管理工作目录路径

Architecture

架构

Minions is built with TypeScript and uses:

SQLite for local task metadata storage
Hermes Agent sessions for chat transcripts
Real-time WebSocket connections for live streaming
Kanban board UI for task visualization

typescript

// Example: Task state transitions
// 1. User creates task → status: 'in_progress'
// 2. Agent completes work → status: 'in_review'
// 3. Human verifies → status: 'done'

// The completion judge runs after each agent turn
interface CompletionCheck {
  isComplete: boolean;
  reasoning: string;
  confidence: number;
}

Minions基于TypeScript构建，使用以下技术：

SQLite用于本地任务元数据存储
Hermes Agent会话用于聊天记录
实时WebSocket连接用于实时流传输
看板UI用于任务可视化

typescript

// 示例：任务状态转换
// 1. 用户创建任务 → 状态: 'in_progress'
// 2. Agent完成工作 → 状态: 'in_review'
// 3. 人工验证 → 状态: 'done'

// 完成判断在Agent每一轮交互后运行
interface CompletionCheck {
  isComplete: boolean;
  reasoning: string;
  confidence: number;
}

Common Patterns

常见使用模式

Delegating Long-Running Work

委派长期运行的工作

bash

undefined

bash

undefined

Start Minions

启动Minions

npx minionsai

In the web UI:

在Web UI中：

1. Create new task: "Research top 10 AI tools launched this month"

1. 创建新任务："研究本月发布的Top 10 AI工具"

2. Walk away - agent executes autonomously

2. 离开 - Agent自主执行任务

3. Return later to review in "In Review" column

3. 稍后返回，在"审核中"列查看结果

4. Verify and move to "Done"

4. 验证后移至"已完成"

undefined

undefined

Managing Multiple Projects

管理多个项目

typescript

// Each task is independent:
// - Separate Hermes session
// - Independent model/effort settings
// - Parallel execution supported

// Example workflow:
// Task 1: "Write blog post about TypeScript 5.4 features"
// Task 2: "Analyze competitor pricing pages"
// Task 3: "Generate test data for user onboarding flow"
// All run concurrently, visible on one board

typescript

// 每个任务相互独立：
// - 独立的Hermes会话
// - 独立的模型/推理强度设置
// - 支持并行执行

// 示例工作流：
// 任务1："撰写关于TypeScript 5.4特性的博客文章"
// 任务2："分析竞争对手的定价页面"
// 任务3："为用户注册流程生成测试数据"
// 所有任务同时运行，在同一个面板中可见

Routine Monitoring

例行监控

bash

undefined

bash

undefined

Set up daily routine:

设置每日例行任务：

"Check GitHub stars and create summary report"

"检查GitHub星标并创建汇总报告"

Minions will:

Minions会：

1. Execute on schedule

1. 按计划执行

2. Store execution history

2. 存储执行历史

3. Make output reviewable

3. 让输出可审核

4. Alert if intervention needed (roadmap feature)

4. 如需干预则发出警报（规划中功能）

undefined

undefined

Integration with Hermes Agent

与Hermes Agent的集成

Minions acts as a control layer over Hermes:

typescript

// Minions doesn't replace Hermes CLI usage
// It complements it by providing:
// - Visual task organization
// - Persistent session management
// - Completion detection
// - Human review workflow

// You can still use Hermes directly:
hermes chat "quick question"

// Or use Minions for longer work:
// Create task in UI → Minions manages Hermes session

Minions作为Hermes的控制层：

typescript

// Minions不会替代Hermes CLI的使用
// 它通过以下功能进行补充：
// - 可视化任务组织
// - 持久化会话管理
// - 完成检测
// - 人工审核工作流

// 你仍然可以直接使用Hermes：
hermes chat "quick question"

// 或者使用Minions处理长期工作：
// 在UI中创建任务 → Minions管理Hermes会话

Troubleshooting

故障排除

Port Already in Use

端口已被占用

bash

undefined

bash

undefined

Default port is 6969

默认端口是6969

If occupied, check for existing Minions process:

如果被占用，检查是否有运行中的Minions进程：

lsof -i :6969 kill -9 <PID>

Then restart

然后重启

npx minionsai

undefined

npx minionsai

undefined

Database Issues

数据库问题

bash

undefined

bash

undefined

Database location

数据库位置

ls -la ~/.minions/

Reset database (WARNING: deletes all tasks)

重置数据库（警告：会删除所有任务）

rm -rf ~/.minions/ npx minionsai # Creates fresh database

undefined

rm -rf ~/.minions/ npx minionsai # 创建新的数据库

undefined

Connection to Hermes Agent

与Hermes Agent的连接问题

Ensure Hermes Agent is properly installed and accessible:

bash

undefined

确保Hermes Agent已正确安装且可访问：

bash

undefined

Verify Hermes installation

验证Hermes安装

which hermes hermes --version

Check Hermes can start sessions

检查Hermes能否启动会话

hermes chat "test"

undefined

hermes chat "test"

undefined

Task Stuck in "In Progress"

任务卡在"进行中"状态

Check Hermes session logs for errors
Review agent's last output in live stream
Manually intervene in chat
Adjust model/reasoning effort settings
Close and recreate task if necessary

检查Hermes会话日志是否有错误
在实时流中查看Agent的最后输出
在聊天中手动干预
调整模型/推理强度设置
必要时关闭并重新创建任务

Hosted Option

托管选项

Self-hosting is recommended for privacy, but a hosted option is available at Agent37.

出于隐私考虑，推荐自托管，但也可使用Agent37提供的托管服务。

Limitations

局限性

Currently Hermes-only (OpenClaw adapter planned)
Notifications not yet implemented (roadmap)
Skills library not yet available (roadmap)

当前仅支持Hermes（计划适配OpenClaw）
尚未实现通知功能（规划中）
技能库尚未可用（规划中）