From fe01d58064af377a698efe6e10f44f9173afc0cb Mon Sep 17 00:00:00 2001 From: devv-eve Date: Thu, 16 Apr 2026 23:39:48 -0700 Subject: [PATCH] docs(cli): document project commands and --project flag for issues (#1253) The project CRUD commands (list, get, create, update, delete, status) and the `--project` flag on issue commands have been implemented in the CLI but were not yet documented. Add them to both the docs site reference and the repo-level CLI_AND_DAEMON.md so the feature is discoverable. Closes MUL-867 Co-authored-by: Eve Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- CLI_AND_DAEMON.md | 68 +++++++++++++++++++++++- apps/docs/content/docs/cli/reference.mdx | 68 +++++++++++++++++++++++- 2 files changed, 132 insertions(+), 4 deletions(-) diff --git a/CLI_AND_DAEMON.md b/CLI_AND_DAEMON.md index c6198fe22..854c5fe83 100644 --- a/CLI_AND_DAEMON.md +++ b/CLI_AND_DAEMON.md @@ -278,7 +278,7 @@ multica issue list --priority urgent --assignee "Agent Name" multica issue list --limit 20 --output json ``` -Available filters: `--status`, `--priority`, `--assignee`, `--limit`. +Available filters: `--status`, `--priority`, `--assignee`, `--project`, `--limit`. ### Get Issue @@ -293,7 +293,7 @@ multica issue get --output json multica issue create --title "Fix login bug" --description "..." --priority high --assignee "Lambda" ``` -Flags: `--title` (required), `--description`, `--status`, `--priority`, `--assignee`, `--parent`, `--due-date`. +Flags: `--title` (required), `--description`, `--status`, `--priority`, `--assignee`, `--parent`, `--project`, `--due-date`. ### Update Issue @@ -349,6 +349,70 @@ multica issue run-messages --since 42 --output json The `runs` command shows all past and current executions for an issue, including running tasks. The `run-messages` command shows the detailed message log (tool calls, thinking, text, errors) for a single run. Use `--since` for efficient polling of in-progress runs. +## Projects + +Projects group related issues (e.g. a sprint, an epic, a workstream). Every project +belongs to a workspace and can optionally have a lead (member or agent). + +### List Projects + +```bash +multica project list +multica project list --status in_progress +multica project list --output json +``` + +Available filters: `--status`. + +### Get Project + +```bash +multica project get +multica project get --output json +``` + +### Create Project + +```bash +multica project create --title "2026 Week 16 Sprint" --icon "🏃" --lead "Lambda" +``` + +Flags: `--title` (required), `--description`, `--status`, `--icon`, `--lead`. + +### Update Project + +```bash +multica project update --title "New title" --status in_progress +multica project update --lead "Lambda" +``` + +Flags: `--title`, `--description`, `--status`, `--icon`, `--lead`. + +### Change Status + +```bash +multica project status in_progress +``` + +Valid statuses: `planned`, `in_progress`, `paused`, `completed`, `cancelled`. + +### Delete Project + +```bash +multica project delete +``` + +### Associating Issues with Projects + +Use the `--project` flag on `issue create` / `issue update` to attach an issue to a +project, or on `issue list` to filter issues by project: + +```bash +multica issue create --title "Login bug" --project +multica issue update --project +multica issue list --project +``` + ## Setup ```bash diff --git a/apps/docs/content/docs/cli/reference.mdx b/apps/docs/content/docs/cli/reference.mdx index a9251d6f6..f43c534cd 100644 --- a/apps/docs/content/docs/cli/reference.mdx +++ b/apps/docs/content/docs/cli/reference.mdx @@ -212,7 +212,7 @@ multica issue list --priority urgent --assignee "Agent Name" multica issue list --limit 20 --output json ``` -Available filters: `--status`, `--priority`, `--assignee`, `--limit`. +Available filters: `--status`, `--priority`, `--assignee`, `--project`, `--limit`. ### Get Issue @@ -227,7 +227,7 @@ multica issue get --output json multica issue create --title "Fix login bug" --description "..." --priority high --assignee "Lambda" ``` -Flags: `--title` (required), `--description`, `--status`, `--priority`, `--assignee`, `--parent`, `--due-date`. +Flags: `--title` (required), `--description`, `--status`, `--priority`, `--assignee`, `--parent`, `--project`, `--due-date`. ### Update Issue @@ -281,6 +281,70 @@ multica issue run-messages --output json multica issue run-messages --since 42 --output json ``` +## Projects + +Projects group related issues (e.g. a sprint, an epic, a workstream). Every project +belongs to a workspace and can optionally have a lead (member or agent). + +### List Projects + +```bash +multica project list +multica project list --status in_progress +multica project list --output json +``` + +Available filters: `--status`. + +### Get Project + +```bash +multica project get +multica project get --output json +``` + +### Create Project + +```bash +multica project create --title "2026 Week 16 Sprint" --icon "🏃" --lead "Lambda" +``` + +Flags: `--title` (required), `--description`, `--status`, `--icon`, `--lead`. + +### Update Project + +```bash +multica project update --title "New title" --status in_progress +multica project update --lead "Lambda" +``` + +Flags: `--title`, `--description`, `--status`, `--icon`, `--lead`. + +### Change Status + +```bash +multica project status in_progress +``` + +Valid statuses: `planned`, `in_progress`, `paused`, `completed`, `cancelled`. + +### Delete Project + +```bash +multica project delete +``` + +### Associating Issues with Projects + +Use the `--project` flag on `issue create` / `issue update` to attach an issue to a +project, or on `issue list` to filter issues by project: + +```bash +multica issue create --title "Login bug" --project +multica issue update --project +multica issue list --project +``` + ## Configuration ### View Config