UNPKG

@kontextmind/kxm

Version:

KXM local-first multi-agent orchestration and operator dashboard

github.com/kontextmind/kxm

kontextmind/kxm

48 lines (39 loc) • 2.49 kB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
--- name: kxm-tasks description: Recommend workflows and manage goals and tasks, recording a GitHub issue or Jira key on a task without contacting either tracker. Use when asked what workflow fits, to plan work as goals and tasks, or to link a task to a GitHub or Jira issue. Run a kxm suggest workflow ID only after kxm workflow definitions lists it. --- # KXM suggest, goals, and tasks A task can record a GitHub issue or Jira key, but no command contacts either tracker: `kxm task sync` marks only the local task record synced, and `--tracker` is not validated. Do not invent `suggest workflows` or extra task verbs. ## Commands | Command | Purpose | Options / arguments | |---|---|---| | `kxm suggest <prompt...>` | Recommend workflow, area, roles, and skills | `--json` | | `kxm goal create <title>` | Create a project goal | `--area`, `--metric`, `--target-date` | | `kxm goal list` | List project goals | `--json` | | `kxm task create <title>` | Create a task | `--goal`, `--objective`, `--workflow`, `--tracker github\|jira`, `--issue <number-or-key>` | | `kxm task list` | List project tasks | `--goal`, `--status todo\|in_progress\|blocked\|in_review\|done` | | `kxm task get <taskId>` | Task details and linked workflow status | `--json` | | `kxm task run <taskId>` | Launch a workflow run driven by this task | `--json` | | `kxm task sync <taskId>` | Mark the local task record synced; contacts no tracker | `--json` | ```bash kxm suggest "implement trusted roster policy brakes" --json kxm workflow definitions kxm goal create "Land the skills suite" --area software-engineering --json kxm task create "Repair trust loader" --goal goal_1 --tracker github --issue 127 --json kxm task list --status in_progress --json kxm task sync task_1 --json ``` ## Suggested workflows `kxm suggest` picks its workflow ID from a built-in catalog, and that ID may not exist in this project. Before running the suggested `kxm run` command, confirm that `kxm workflow definitions` lists the ID; otherwise `kxm run` fails with `run_workflow_unknown`. Pick a listed workflow instead, or write one with the user (`kxm-project-setup`). `--issue` on `kxm task create` is a tracker issue number or Jira key, not a credential. In this build `kxm task sync` marks only the local task record synced; it does not contact GitHub or Jira. `kxm task create` accepts any `--tracker` value and records it unchecked, so pass only `github` or `jira`, and never report a task as synced with a tracker.