hermes project 命令 — 完整参考与示例

概述

hermes project 管理可跨多个文件夹或仓库的人工命名工作空间。项目锚定桌面会话分组，并在绑定看板时提供确定性的工作树 + 分支约定。项目状态按 Profile 隔离。

hermes project {create,list,ls,show,add-folder,remove-folder,rename,set-primary,use,archive,restore,bind-board}

子命令

create

创建新项目。

hermes project create "Hermes Agent" ~/dev/hermes --use

选项：

• --slug SLUG — 显式指定 slug
• --primary PATH — 主仓库路径
• --description DESCRIPTION
• --icon ICON
• --color COLOR
• --board SLUG — 绑定看板
• --use — 设为活动项目

list（ls）

列出项目。

hermes project list
hermes project list --all   # 包含已归档项目

show

查看项目详情。

hermes project show my-project

add-folder

向项目添加文件夹。

hermes project add-folder my-project ~/dev/docs --label docs --primary

remove-folder

从项目移除文件夹。

hermes project remove-folder my-project ~/dev/docs

rename

重命名项目。

hermes project rename my-project "New Name"

set-primary

设置主文件夹。该路径必须已在项目中。

hermes project set-primary my-project ~/dev/hermes

use

设置活动项目，或省略项目以清除。

hermes project use my-project
hermes project use          # 清除活动项目

archive

归档项目。

hermes project archive old-project

restore

恢复已归档项目。

hermes project restore old-project

bind-board

绑定看板到项目，或省略看板以解绑。

hermes project bind-board my-project board-slug
hermes project bind-board my-project   # 解绑

常见场景

创建新项目

hermes project create "My SaaS" ~/code/api ~/code/web --use

添加文档和基础设施文件夹

hermes project add-folder my-saas ~/code/docs --label docs
hermes project add-folder my-saas ~/code/infra --label infra

切换活动项目

hermes project list
hermes project use my-saas

绑定看板

hermes project bind-board my-saas roadmap

归档已完成项目

hermes project archive my-saas
hermes project list --all

提示

• 项目定义按 Profile 隔离；不同 Profile 可拥有不同项目。
• 传递给 create 的第一个文件夹会成为主文件夹，除非使用 --primary 指定。
• 当项目有多个仓库时，使用 set-primary 指定主入口。
• 绑定看板后，Agent 任务会获得确定性的工作树和分支约定。