starhui-dev/huly-cli

Huly CLI

Verwenden Sie npx -y @starhui/huly-cli@latest, um über @firfi/huly-mcp mit Huly zu arbeiten.

Für die lokale Entwicklung innerhalb dieses Repositorys ist huly nach pnpm build && pnpm link --global ebenfalls akzeptabel.

Schnellchecks

1. Stellen Sie sicher, dass die CLI verfügbar ist:

   npx -y @starhui/huly-cli@latest --version
   

2. Prüfen Sie zunächst die bereinigte Konfiguration aus vorhandenen Umgebungsvariablen:

   npx -y @starhui/huly-cli@latest context
   

3. Fehlt die erforderliche Konfiguration, fragen Sie den Benutzer, ob eine explizite Dotenv-Datei mit --config <pfad> übergeben werden soll.
4. Wenn bei Issue-Befehlen kein Projekt angegeben wird, setzen Sie HULY_DEFAULT_PROJECT oder übergeben Sie --project.

Geben Sie niemals echte Tokens, Passwörter oder vollständige .env-Inhalte preis. npx -y @starhui/huly-cli@latest context ist sicher, da es bereinigte Konfiguration zurückgibt.

Häufige Befehle

Projekte auflisten:

npx -y @starhui/huly-cli@latest project list --json

Status vor dem Erstellen oder Aktualisieren von Issues ermitteln:

npx -y @starhui/huly-cli@latest project statuses HULY --json

Issues auflisten:

npx -y @starhui/huly-cli@latest issue list --project HULY --status-category active --limit 20 --json

Issue abrufen:

npx -y @starhui/huly-cli@latest issue get HULY-123 --project HULY --json

Issue erstellen:

npx -y @starhui/huly-cli@latest issue create --project HULY --title "Kurzer imperativer Titel" --description "Markdown-Body"

Issue aktualisieren:

npx -y @starhui/huly-cli@latest issue update HULY-123 --project HULY --status Erledigt

Suchen:

npx -y @starhui/huly-cli@latest search "Suchtext" --limit 10 --json

Roh-Toolzugriff

Verwenden Sie Rohaufrufe, wenn das primäre CLI kein übergeordnetes MCP-Tool bereitstellt:

npx -y @starhui/huly-cli@latest tools --filter dokument
npx -y @starhui/huly-cli@latest call get_issue --field project=HULY --field identifier=HULY-123 --json
npx -y @starhui/huly-cli@latest call list_projects --data '{"limit":10}' --json

--field key=value wandelt true, false, null und Zahlen um. Verwenden Sie --data oder --file für verschachteltes JSON.

Sicherheit

• Verwenden Sie --json für die Agenten-Parsing.
• Lesen Sie vor dem Schreiben: Überprüfen Sie das Projekt/den Status/das Issue vor der Änderung, sofern der Benutzer keine genauen Werte angegeben hat.
• Zerstörerische Befehle erfordern eine Bestätigung; übergeben Sie --yes nur, wenn der Benutzer die Löschung ausdrücklich angefordert hat.
• Bevorzugen Sie Statusnamen aus project statuses; erfinden Sie keine Workflow-Status.
• Wenn ein Befehl aufgrund von Authentifizierung/Konfiguration fehlschlägt, melden Sie die fehlenden bereinigten Felder aus npx -y @starhui/huly-cli@latest context; geben Sie keine Geheimnisse preis. Wiederholen Sie den Vorgang nur mit --config <pfad>, nachdem der Benutzer bestätigt hat, welche Dotenv-Datei verwendet werden soll.

Nützliche Zuordnung

• Projekte: project list, project get, project statuses, project create, project update, project delete.
• Issues: issue list, issue get, issue create, issue update, issue delete, issue label, issue unlabel, issue move.
• Globale Suche: search.
• Alle übergeordneten MCP-Tools: tools und call.