hermes project Command — Complete Reference & Examples

Overview

hermes project manages human-named workspaces that can span multiple folders or repositories. Projects anchor desktop session grouping and, when bound to a kanban board, provide a deterministic worktree + branch convention. Project state is per-profile.

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

Subcommands

create

Create a new project.

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

Options:

• --slug SLUG — explicit slug override
• --primary PATH — primary repo path
• --description DESCRIPTION
• --icon ICON
• --color COLOR
• --board SLUG — bind a kanban board
• --use — set as the active project

list (ls)

List projects.

hermes project list
hermes project list --all   # include archived projects

show

Show project details.

hermes project show my-project

add-folder

Add a folder to a project.

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

remove-folder

Remove a folder from a project.

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

rename

Rename a project.

hermes project rename my-project "New Name"

set-primary

Set the primary folder. The path must already be in the project.

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

use

Set the active project, or omit the project to clear it.

hermes project use my-project
hermes project use          # clear active project

archive

Archive a project.

hermes project archive old-project

restore

Restore an archived project.

hermes project restore old-project

bind-board

Bind a kanban board to a project, or omit the board to unbind.

hermes project bind-board my-project board-slug
hermes project bind-board my-project   # unbind

Common Scenarios

Creating a new project

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

Adding documentation and infrastructure folders

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

Switching active projects

hermes project list
hermes project use my-saas

Binding a kanban board

hermes project bind-board my-saas roadmap

Archiving a completed project

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

Tips

• Project definitions are per-profile; different profiles can have different projects.
• The first folder passed to create becomes the primary folder unless you use --primary.
• Use set-primary when a project has multiple repos but one is the main entry point.
• Binding a board gives agent tasks a deterministic worktree and branch convention.