@markus-global/cli 0.6.1 → 0.6.3

package/templates/skills/markus-agent-cli/SKILL.md

@@ -1,69 +0,0 @@
----
-name: markus-agent-cli
-description: Manage agents via markus CLI — lifecycle, messaging, config, memory, skills.
----
-
-# Agent Management via CLI
-
-> **IMPORTANT**: Prefer built-in tools (`team_hire_agent`, `builder_install`, `agent_send_message`, `task_create`, `task_assign`, `memory_save`, etc.) over CLI commands. Only use CLI when no built-in tool provides the needed operation (e.g., `agent delete`, `agent config`, `agent role-sync`).
-
-Operate agents through `shell_execute` with `markus agent` commands. Always use `--json` for parseable output.
-
-## Quick examples
-
-```bash
-# List all agents
-markus agent list --json
-
-# Get agent details
-markus agent get agt_xxx --json
-
-# Create an agent
-markus agent create --name "Alice" --role developer --team team_xxx
-
-# Start / stop agents
-markus agent start agt_xxx
-markus agent stop agt_xxx
-
-# Send a message
-markus agent message agt_xxx --text "Please review the API changes"
-
-# Update config
-markus agent config agt_xxx --skills "self-evolution,chrome-devtools"
-
-# View memory
-markus agent memory agt_xxx --json
-
-# Manage skills
-markus agent skill-add agt_xxx --skill-name chrome-devtools
-markus agent skill-remove agt_xxx --skill-name chrome-devtools
-
-# Trigger heartbeat or daily report
-markus agent heartbeat agt_xxx
-markus agent daily-report agt_xxx
-
-# Sync role from template
-markus agent role-sync agt_xxx
-```
-
-## Command Reference
-
-| Command | Key Options |
-|---------|-------------|
-| `agent list` | |
-| `agent get <id>` | |
-| `agent create` | `--name` (required) `--role` (required) `--org` `--team` `--agent-role` `--skills` |
-| `agent delete <id>` | `--purge` |
-| `agent start <id>` | |
-| `agent stop <id>` | |
-| `agent message <id>` | `--text` (required) `--sender` `--session` |
-| `agent chat <id>` | Interactive REPL mode |
-| `agent config <id>` | `--name` `--agent-role` `--skills` `--heartbeat` |
-| `agent memory <id>` | |
-| `agent files <id>` | |
-| `agent skill-add <id>` | `--skill-name` (required) |
-| `agent skill-remove <id>` | `--skill-name` (required) |
-| `agent activities <id>` | `--type` `--limit` |
-| `agent heartbeat <id>` | |
-| `agent daily-report <id>` | |
-| `agent role-sync <id>` | |

package/templates/skills/markus-agent-cli/skill.json

@@ -1,21 +0,0 @@
-{
-  "type": "skill",
-  "name": "markus-agent-cli",
-  "displayName": "Markus Agent CLI",
-  "version": "1.0.0",
-  "description": "Manage agents via markus CLI — lifecycle, messaging, config, memory, skills.",
-  "author": "markus",
-  "category": "platform",
-  "tags": ["cli", "agents", "lifecycle"],
-  "hidden": true,
-  "i18n": {
-    "zh-CN": {
-      "displayName": "Markus 智能体命令行",
-      "description": "通过 markus CLI 管理智能体 — 生命周期、消息通信、配置、记忆、技能。"
-    }
-  },
-  "skill": {
-    "skillFile": "SKILL.md",
-    "alwaysOn": false
-  }
-}

package/templates/skills/markus-cli/SKILL.md

@@ -1,113 +0,0 @@
----
-name: markus-cli
-description: Core knowledge for operating the Markus platform via CLI. Prerequisite for domain-specific markus-*-cli skills.
----
-
-# Markus CLI
-
-The `markus` command-line tool lets you operate the Markus platform programmatically.
-Use it via `shell_execute` to manage agents, projects, tasks, teams, and more.
-
-## How to invoke
-
-Use `markus` via `shell_execute`. The binary is automatically available in PATH — either from npm global install (`npm install -g @markus-global/cli`) or injected by the server at startup in source-dev mode.
-
-```bash
-markus agent list --json
-markus project task get tsk_abc123 --json
-markus admin system status --json
-```
-
-## Prerequisites
-
-- The Markus server must be running (started via `markus start`).
-- `markus start` auto-detects first run and initializes everything (DB, config wizard).
-- The CLI connects to `http://localhost:8056` by default. Override with `--server <url>` or `MARKUS_API_URL`.
-- For authenticated access use `--api-key <key>` or `MARKUS_API_KEY`.
-
-## Output format
-
-**Always use `--json` when parsing results programmatically.** Without `--json`, output is human-readable tables.
-
-```bash
-# Machine-readable — use this in automation
-markus agent list --json
-
-# Human-readable table
-markus agent list
-```
-
-## Platform Info
-
-- **Website**: https://www.markus.global/
-- **GitHub**: https://github.com/markus-global/markus
-
-## Command structure
-
-Commands follow the pattern: `markus <domain> [sub] <action> [id] [options]`
-
-```bash
-markus agent list                        # List agents
-markus project list --json               # List projects
-markus project task create --title "..."  # Create a task
-markus admin system status               # System health
-markus admin system version --json       # Check version and updates
-markus <domain> --help                   # See all subcommands
-```
-
-## Command hierarchy
-
-| Command | Description | Skill |
-|---------|-------------|-------|
-| `start` | Start server (auto-init on first run) | — |
-| `agent` | Agent lifecycle, config, memory, skills | markus-agent-cli |
-| `team` | Team CRUD, members, lifecycle | markus-team-cli |
-| `skill` | Skill registry, install, scaffold | markus-skill-cli |
-| `project` | Project CRUD | markus-project-cli |
-| `project task` | Task CRUD, lifecycle, subtasks, comments | markus-project-cli |
-| `project requirement` | Requirement CRUD, approval | markus-project-cli |
-| `project deliverable` | Deliverable CRUD | markus-project-cli |
-| `project report` | Report generation, usage stats | markus-project-cli |
-| `project review` | Code / task reviews | markus-project-cli |
-| `project approval` | HITL approvals | markus-project-cli |
-| `admin` | Platform administration & system controls | markus-admin-cli |
-| `admin system` | Global controls, governance, storage, version, update | markus-admin-cli |
-| `admin system audit` | Audit log and summary | markus-admin-cli |
-| `admin user` | Human user management | markus-admin-cli |
-| `admin key` | API key management | markus-admin-cli |
-| `admin role` | Role templates | markus-admin-cli |
-| `admin template` | Agent/team templates | markus-admin-cli |
-| `admin builder` | Builder artifacts | markus-admin-cli |
-| `admin gateway` | External agent gateway | markus-admin-cli |
-| `admin settings` | LLM and platform settings | markus-admin-cli |
-| `admin external-agent` | External agent registration | markus-admin-cli |
-
-## Installation & Update
-
-```bash
-# Install via npm (recommended)
-npm install -g @markus-global/cli
-
-# Or one-line install
-curl -fsSL https://markus.global/install.sh | bash
-
-# Check current version
-markus admin system version --json
-
-# Update to latest (npm mode)
-npm update -g @markus-global/cli
-
-# Update to latest (source mode — pulls from GitHub, installs deps, rebuilds)
-markus admin system update
-
-# Preview update without making changes
-markus admin system update --dry-run
-```
-
-**Always confirm with the user before updating** — it requires a service restart which interrupts running agents.
-
-## Tips
-
-- Always use `--json` and parse the JSON output for reliable automation.
-- When creating tasks, always specify `--project-id` if projects exist.
-- Use `markus <domain> --help` to discover available subcommands and options.

package/templates/skills/markus-cli/skill.json

@@ -1,20 +0,0 @@
-{
-  "type": "skill",
-  "name": "markus-cli",
-  "displayName": "Markus CLI",
-  "version": "1.0.0",
-  "description": "Core knowledge for operating the Markus platform via CLI commands. Prerequisite for all markus-*-cli skills.",
-  "author": "markus",
-  "category": "platform",
-  "tags": ["cli", "platform", "management", "api"],
-  "i18n": {
-    "zh-CN": {
-      "displayName": "Markus 命令行",
-      "description": "通过 CLI 命令操作 Markus 平台的核心知识，是所有 markus-*-cli 技能的前置依赖。"
-    }
-  },
-  "skill": {
-    "skillFile": "SKILL.md",
-    "alwaysOn": false
-  }
-}

package/templates/skills/markus-project-cli/SKILL.md

@@ -1,163 +0,0 @@
----
-name: markus-project-cli
-description: Manage projects, tasks, requirements, deliverables, reports, reviews, and approvals via markus CLI.
----
-
-# Project & Task Management via CLI
-
-> **IMPORTANT**: Prefer built-in tools (`task_create`, `task_update`, `task_list`, `task_assign`, `task_comment`, `requirement_propose`, `requirement_list`, `deliverable_create`, `deliverable_search`, etc.) over CLI commands. Only use CLI when no built-in tool provides the needed operation (e.g., `task approve`, `task revision`, `project create/delete`, `report generate`).
-
-Operate projects, tasks, requirements, deliverables, reports, reviews, and approvals through `shell_execute` with `markus` commands. Always use `--json` for parseable output.
-
-## Projects
-
-```bash
-markus project list --json
-markus project get proj_xxx --json
-markus project create --name "Web App v2" --org-id default --description "Next version"
-markus project update proj_xxx --description "Updated scope"
-markus project delete proj_xxx
-```
-
-| Command | Key Options |
-|---------|-------------|
-| `project list` | `--org <id>` |
-| `project get <id>` | |
-| `project create` | `--name` (required) `--org` `--description` `--repositories` `--team-ids` |
-| `project update <id>` | `--name` `--description` `--status` `--repositories` `--team-ids` |
-| `project delete <id>` | |
-
-## Tasks (nested under project)
-
-```bash
-markus project task list --status in_progress --json
-markus project task create --title "Implement login page" --priority high --assignee agt_xxx --project-id proj_xxx
-markus project task run tsk_xxx
-markus project task get tsk_xxx --json
-markus project task approve tsk_xxx
-markus project task accept tsk_xxx
-markus project task revision tsk_xxx --reason "Tests are missing"
-```
-
-### CRUD
-
-| Command | Options |
-|---------|---------|
-| `project task list` | `--status` `--agent-id` `--project-id` `--requirement-id` `--org-id` `--limit` |
-| `project task get <id>` | |
-| `project task create` | `--title` (required) `--description` `--priority` `--assignee` `--reviewer` `--project-id` `--blocked-by` `--type` |
-| `project task update <id>` | `--title` `--description` `--priority` `--status` `--assignee` `--reviewer` `--project-id` `--blocked-by` |
-| `project task dashboard` | `--org-id` |
-| `project task board` | `--org-id` `--project-id` |
-
-### Lifecycle Actions
-
-| Command | Options |
-|---------|---------|
-| `project task approve <id>` | |
-| `project task reject <id>` | |
-| `project task run <id>` | |
-| `project task pause <id>` | |
-| `project task resume <id>` | |
-| `project task retry <id>` | |
-| `project task cancel <id>` | `--cascade` |
-| `project task accept <id>` | |
-| `project task revision <id>` | `--reason` |
-| `project task archive <id>` | |
-
-### Subtasks & Comments
-
-| Command | Options |
-|---------|---------|
-| `project task subtasks <id>` | |
-| `project task subtask-add <id>` | `--title` (required) |
-| `project task comment <id>` | `--content` (required) `--author-id` `--author-name` |
-| `project task logs <id>` | |
-
-### Task State Flow
-
-```
-pending → in_progress → review → completed → archived
-         (blocked / failed / cancelled along the way)
-```
-
-## Requirements (nested under project)
-
-```bash
-markus project requirement list --project proj_xxx --json
-markus project requirement create --title "User auth" --project proj_xxx --priority high
-markus project requirement approve req_xxx
-markus project requirement reject req_xxx --reason "Out of scope"
-```
-
-| Command | Key Options |
-|---------|-------------|
-| `project requirement list` | `--org` `--status` `--project` `--source` |
-| `project requirement get <id>` | |
-| `project requirement create` | `--title` (required) `--description` `--priority` `--project` `--org` `--tags` |
-| `project requirement update <id>` | `--title` `--description` `--priority` `--tags` |
-| `project requirement approve <id>` | |
-| `project requirement reject <id>` | `--reason` |
-| `project requirement delete <id>` | |
-
-### Requirement State Flow
-
-```
-pending → in_progress → completed
-       → rejected / cancelled
-```
-
-## Deliverables (nested under project)
-
-```bash
-markus project deliverable list --project-id proj_xxx --json
-markus project deliverable create --title "API Design Doc" --type knowledge --project-id proj_xxx
-markus project deliverable update dlv_xxx --status verified
-markus project deliverable delete dlv_xxx
-```
-
-| Command | Key Options |
-|---------|-------------|
-| `project deliverable list` | `--query` `--project` `--agent` `--task` `--type` `--status` `--limit` `--offset` |
-| `project deliverable create` | `--title` (required) `--type` `--summary` `--reference` `--tags` `--task` `--agent` `--project` |
-| `project deliverable update <id>` | `--title` `--summary` `--reference` `--tags` `--status` `--type` |
-| `project deliverable delete <id>` | |
-
-## Reports & Usage (nested under project)
-
-```bash
-markus project report generate --period weekly --scope org
-markus project report usage --json
-```
-
-| Command | Key Options |
-|---------|-------------|
-| `project report list` | `--scope` `--scope-id` `--type` |
-| `project report generate` | `--period` (required: daily/weekly/monthly) `--scope` `--org` |
-| `project report usage` | `--org` |
-
-## Code Reviews (nested under project)
-
-```bash
-markus project review run --task-id tsk_xxx --agent-id agt_xxx --description "PR review"
-markus project review list --task-id tsk_xxx --json
-markus project review get rev_xxx --json
-```
-
-| Command | Key Options |
-|---------|-------------|
-| `project review run` | `--task` (required) `--agent` (required) `--description` `--changed-files` |
-| `project review list` | `--task` `--limit` |
-| `project review get <id>` | |
-
-## Approvals (nested under project)
-
-```bash
-markus project approval list --task-id tsk_xxx --json
-markus project approval process apv_xxx --action approve
-```
-
-| Command | Key Options |
-|---------|-------------|
-| `project approval list` | `--task` `--status` |
-| `project approval process <id>` | `--action` (approve/reject) `--reason` |

package/templates/skills/markus-project-cli/skill.json

@@ -1,21 +0,0 @@
-{
-  "type": "skill",
-  "name": "markus-project-cli",
-  "displayName": "Markus Project CLI",
-  "version": "1.0.0",
-  "description": "Manage projects, requirements, deliverables, reports, and code reviews via markus CLI.",
-  "author": "markus",
-  "category": "platform",
-  "tags": ["cli", "projects", "requirements", "deliverables", "reports"],
-  "hidden": true,
-  "i18n": {
-    "zh-CN": {
-      "displayName": "Markus 项目命令行",
-      "description": "通过 markus CLI 管理项目、需求、交付物、报告和代码审查。"
-    }
-  },
-  "skill": {
-    "skillFile": "SKILL.md",
-    "alwaysOn": false
-  }
-}

package/templates/skills/markus-skill-cli/SKILL.md

@@ -1,59 +0,0 @@
----
-name: markus-skill-cli
-description: Manage skills via markus CLI — list, install, uninstall, search, scaffold.
----
-
-# Skill Management via CLI
-
-> **IMPORTANT**: Prefer built-in tools (`discover_tools` for listing/activating/installing skills) over CLI commands. Only use CLI when no built-in tool provides the needed operation (e.g., `skill uninstall`, `skill init`).
-
-Operate the skill registry through `shell_execute` with `markus skill` commands. Always use `--json` for parseable output.
-
-## Quick examples
-
-```bash
-# List installed skills
-markus skill list --json
-
-# List built-in template skills
-markus skill builtin --json
-
-# Search remote registries
-markus skill search --query "browser automation" --json
-
-# Install a skill
-markus skill install --name chrome-devtools --source builtin
-
-# Uninstall a skill
-markus skill uninstall chrome-devtools
-
-# Scaffold a new custom skill
-markus skill init --name my-skill
-```
-
-## Command Reference
-
-| Command | Key Options |
-|---------|-------------|
-| `skill list` | |
-| `skill builtin` | |
-| `skill search` | `--query` |
-| `skill install` | `--name` (required) `--source` |
-| `skill uninstall <name>` | |
-| `skill init` | `--name` `--dir` |
-
-## Skill types
-
-- **Built-in**: Ship with Markus (e.g. `chrome-devtools`, `self-evolution`)
-- **Custom**: User-created, stored locally
-- **Registry**: Discovered via `skill search`, installed from remote sources
-
-## Scaffold structure
-
-`markus skill init --name my-skill` creates:
-
-```
-my-skill/
-  skill.json    # Metadata (name, version, category, tags)
-  SKILL.md      # Instructions for the agent
-```

package/templates/skills/markus-skill-cli/skill.json

@@ -1,21 +0,0 @@
-{
-  "type": "skill",
-  "name": "markus-skill-cli",
-  "displayName": "Markus Skill CLI",
-  "version": "1.0.0",
-  "description": "Manage skills via markus CLI — list, install, uninstall, search, scaffold.",
-  "author": "markus",
-  "category": "platform",
-  "tags": ["cli", "skills", "registry"],
-  "hidden": true,
-  "i18n": {
-    "zh-CN": {
-      "displayName": "Markus 技能命令行",
-      "description": "通过 markus CLI 管理技能 — 列出、安装、卸载、搜索、脚手架。"
-    }
-  },
-  "skill": {
-    "skillFile": "SKILL.md",
-    "alwaysOn": false
-  }
-}

package/templates/skills/markus-team-cli/SKILL.md

@@ -1,54 +0,0 @@
----
-name: markus-team-cli
-description: Manage teams via markus CLI — create, members, lifecycle, export.
----
-
-# Team Management via CLI
-
-> **IMPORTANT**: Prefer built-in tools (`team_hire_agent`, `builder_install`, `team_list`, `team_status`, `agent_send_message`, etc.) over CLI commands. Only use CLI when no built-in tool provides the needed operation (e.g., `team delete`, `team export`, `team pause/resume`).
-
-Operate teams through `shell_execute` with `markus team` commands. Always use `--json` for parseable output.
-
-## Quick examples
-
-```bash
-# List teams
-markus team list --json
-
-# Create a team
-markus team create --name "Backend Team" --org default
-
-# Add/remove members
-markus team add-member team_xxx --member agt_xxx --type agent
-markus team remove-member team_xxx agt_xxx
-
-# Team lifecycle
-markus team start team_xxx
-markus team stop team_xxx
-markus team pause team_xxx --reason "Maintenance"
-markus team resume team_xxx
-
-# Team status
-markus team status team_xxx --json
-
-# Export team config
-markus team export team_xxx --json
-```
-
-## Command Reference
-
-| Command | Key Options |
-|---------|-------------|
-| `team list` | `--org` |
-| `team get <id>` | |
-| `team create` | `--name` (required) `--org` `--description` |
-| `team update <id>` | `--name` `--description` `--manager-id` `--manager-type` |
-| `team delete <id>` | `--delete-members` `--purge-files` |
-| `team add-member <id>` | `--member` (required) `--type` (agent/human) |
-| `team remove-member <id> <memberId>` | |
-| `team start <id>` | |
-| `team stop <id>` | |
-| `team pause <id>` | `--reason` |
-| `team resume <id>` | |
-| `team status <id>` | |
-| `team export <id>` | |

package/templates/skills/markus-team-cli/skill.json

@@ -1,21 +0,0 @@
-{
-  "type": "skill",
-  "name": "markus-team-cli",
-  "displayName": "Markus Team CLI",
-  "version": "1.0.0",
-  "description": "Manage teams via markus CLI — create, members, lifecycle, export.",
-  "author": "markus",
-  "category": "platform",
-  "tags": ["cli", "teams", "management"],
-  "hidden": true,
-  "i18n": {
-    "zh-CN": {
-      "displayName": "Markus 团队命令行",
-      "description": "通过 markus CLI 管理团队 — 创建、成员管理、生命周期、导出。"
-    }
-  },
-  "skill": {
-    "skillFile": "SKILL.md",
-    "alwaysOn": false
-  }
-}