hermes project Befehl — Vollständige Referenz & Beispiele

Überblick

hermes project verwaltet menschlich benannte Workspaces, die mehrere Ordner oder Repositories umfassen können. Projekte verankern die Desktop-Session-Gruppierung und liefern bei Bindung an ein Kanban-Board eine deterministische Worktree- + Branch-Konvention. Der Projektstatus ist profilspezifisch.

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

Unterbefehle

create

Erstellt ein neues Projekt.

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

Optionen:

• --slug SLUG — expliziter Slug
• --primary PATH — Pfad des primären Repos
• --description DESCRIPTION
• --icon ICON
• --color COLOR
• --board SLUG — Kanban-Board binden
• --use — Als aktives Projekt setzen

list (ls)

Listet Projekte auf.

hermes project list
hermes project list --all   # archivierte Projekte einschließen

show

Zeigt Projektdetails an.

hermes project show my-project

add-folder

Fügt einem Projekt einen Ordner hinzu.

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

remove-folder

Entfernt einen Ordner aus einem Projekt.

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

rename

Benennt ein Projekt um.

hermes project rename my-project "New Name"

set-primary

Legt den primären Ordner fest. Der Pfad muss bereits im Projekt enthalten sein.

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

use

Setzt das aktive Projekt, oder Projekt weglassen, um es zu löschen.

hermes project use my-project
hermes project use          # Aktives Projekt löschen

archive

Archiviert ein Projekt.

hermes project archive old-project

restore

Stellt ein archiviertes Projekt wieder her.

hermes project restore old-project

bind-board

Bindet ein Kanban-Board an ein Projekt, oder Board weglassen, um die Bindung aufzuheben.

hermes project bind-board my-project board-slug
hermes project bind-board my-project   # Bindung aufheben

Häufige Szenarien

Neues Projekt anlegen

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

Dokumentations- und Infrastruktur-Ordner hinzufügen

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

Aktives Projekt wechseln

hermes project list
hermes project use my-saas

Kanban-Board binden

hermes project bind-board my-saas roadmap

Abgeschlossenes Projekt archivieren

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

Tipps

• Projektdefinitionen sind profilspezifisch — unterschiedliche Profile können unterschiedliche Projekte haben.
• Der erste Ordner, der an create übergeben wird, wird zum primären Ordner, es sei denn, --primary wird verwendet.
• Verwende set-primary, wenn ein Projekt mehrere Repos hat, aber eines der Haupteinstiegspunkt ist.
• Die Bindung an ein Board gibt Agent-Tasks eine deterministische Worktree- und Branch-Konvention.