@contextium/cli 1.0.1 → 1.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@contextium/cli",
3
- "version": "1.0.1",
3
+ "version": "1.0.2",
4
4
  "description": "Command-line tool for managing Contextium documentation, agents, skills, and workflows — pipe context to AI coding assistants",
5
5
  "keywords": [
6
6
  "contextium",
@@ -3,24 +3,115 @@ name: ium:new-project
3
3
  description: Set up a new Contextium project — authenticate, pick a workspace, create libraries, agents, skills, and a workflow
4
4
  allowed-tools:
5
5
  - Bash
6
+ - mcp__contextium__list_workspaces
7
+ - mcp__contextium__create_context_library
8
+ - mcp__contextium__create_agent
9
+ - mcp__contextium__create_skill
10
+ - mcp__contextium__create_workflow
11
+ - mcp__contextium__list_context_libraries
12
+ - mcp__contextium__list_agents
13
+ - mcp__contextium__list_skills
14
+ - mcp__contextium__list_workflows
15
+ - AskUserQuestion
6
16
  ---
7
17
 
8
18
  <objective>
9
- Guide the user through setting up a brand new Contextium project from scratch. This is the first-time onboarding flow authentication, workspace selection, project structure, and workflow creation.
19
+ Set up a new Contextium project — workspace selection, context libraries, agents, skills, and a workflow.
10
20
  </objective>
11
21
 
12
- <process>
13
- Run the following command and let the wizard guide the user interactively:
22
+ <mode-detection>
23
+ Run this once at the start, silently, to determine which mode to use for the entire session:
14
24
 
15
25
  ```bash
16
- contextium setup
26
+ command -v contextium &>/dev/null && echo "cli" || echo "no-cli"
17
27
  ```
18
28
 
19
- If the user wants to reconfigure from scratch, run:
29
+ - If `cli`: use CLI commands throughout. Do not attempt MCP tools.
30
+ - If `no-cli`: check if mcp__contextium__list_workspaces is available. If yes, use MCP tools throughout.
31
+ - If neither: tell the user "Contextium doesn't appear to be installed. Install the CLI with `npm install -g @contextium/cli` or connect the MCP server, then re-run this."
32
+
33
+ Do not mention the mode to the user. Pick one path and stick with it.
34
+ </mode-detection>
35
+
36
+ <process>
20
37
 
38
+ <step name="check_auth">
39
+ **CLI only.** Run silently:
21
40
  ```bash
22
- contextium setup --force
41
+ contextium whoami 2>/dev/null | grep -E "Token:|Name:" || echo "unauthenticated"
23
42
  ```
43
+ If token is expired or unauthenticated, tell the user: "Your Contextium session has expired — run `contextium login` in your terminal, then come back and re-run this." Stop here.
44
+
45
+ MCP users are already authenticated via the server connection — skip this step.
46
+ </step>
47
+
48
+ <step name="select_workspace">
49
+ **CLI:** run `contextium workspace list 2>/dev/null` silently, parse workspace names.
50
+ **MCP:** call mcp__contextium__list_workspaces silently.
51
+
52
+ Ask: "Which workspace is this project for?"
53
+
54
+ Present names only — no IDs, no raw output.
55
+ </step>
56
+
57
+ <step name="project_structure">
58
+ Ask: "What context libraries do you need? (e.g. Product Docs, Internal Guides, Meeting Notes)"
59
+
60
+ **CLI:** `contextium library create "<name>" --workspace <slug>` for each.
61
+ **MCP:** mcp__contextium__create_context_library for each.
62
+
63
+ Show `✓ Created "Library Name"` per library.
64
+ </step>
65
+
66
+ <step name="agents">
67
+ Ask: "Do you want to create any agents? Give them names and a one-line purpose, or say skip."
68
+
69
+ **CLI:** `contextium agent create "<name>" --workspace <slug>` for each.
70
+ **MCP:** mcp__contextium__create_agent for each.
71
+
72
+ Show `✓ Created agent "Name"` per agent.
73
+ </step>
74
+
75
+ <step name="skills">
76
+ Ask: "Any skills to add? Skills are reusable knowledge blocks (e.g. brand guidelines, refund policy). Name them or say skip."
77
+
78
+ **CLI:** `contextium skill create "<name>" --workspace <slug>` for each.
79
+ **MCP:** mcp__contextium__create_skill for each.
80
+
81
+ Show `✓ Created skill "Name"` per skill.
82
+ </step>
83
+
84
+ <step name="workflow">
85
+ Ask: "What should the workflow be called? This bundles your libraries, agents, and skills for quick loading."
86
+
87
+ **CLI:** `contextium workflow create "<name>" --workspace <slug>`.
88
+ **MCP:** mcp__contextium__create_workflow.
89
+
90
+ Show `✓ Created workflow "Name"`.
91
+ </step>
92
+
93
+ <step name="summary">
94
+ Show a clean summary:
95
+
96
+ ```
97
+ ✓ Contextium project ready
98
+
99
+ Workspace: <name>
100
+ Libraries: <list>
101
+ Agents: <list or none>
102
+ Skills: <list or none>
103
+ Workflow: <name>
104
+
105
+ Load it anytime with /ium:workflow.
106
+ ```
107
+ </step>
24
108
 
25
- Do not interrupt or wrap the wizard output — let it run fully interactively.
26
109
  </process>
110
+
111
+ <rules>
112
+ - Never say "the wizard", "Contextium would like to know", or "the next step is"
113
+ - Never show raw bash output, API responses, or IDs to the user
114
+ - Run all checks silently — only surface errors or the final summary
115
+ - Ask questions directly, one step at a time
116
+ - If a CLI command fails, show the error message only — not the full command
117
+ </rules>