@agent-workspace/cli 0.2.0 → 0.2.1

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.
Files changed (2) hide show
  1. package/README.md +100 -0
  2. package/package.json +2 -2
package/README.md ADDED
@@ -0,0 +1,100 @@
1
+ # @agent-workspace/cli
2
+
3
+ CLI for the [Agent Workspace Protocol](https://github.com/marcoloco23/awp) — create, validate, and manage agent workspaces from the terminal.
4
+
5
+ ## Install
6
+
7
+ ```bash
8
+ npm install -g @agent-workspace/cli
9
+ ```
10
+
11
+ ## Commands
12
+
13
+ ### Workspace
14
+
15
+ ```bash
16
+ # Scaffold a new agent workspace
17
+ awp init
18
+
19
+ # Validate workspace structure and schemas
20
+ awp validate
21
+
22
+ # Inspect workspace summary
23
+ awp inspect
24
+ ```
25
+
26
+ ### Identity
27
+
28
+ ```bash
29
+ # Generate a did:key identity
30
+ awp identity generate
31
+
32
+ # Export as A2A-compatible Agent Card (JSON)
33
+ awp identity export
34
+ ```
35
+
36
+ ### Memory
37
+
38
+ ```bash
39
+ # Log a memory entry
40
+ awp memory log --tag learning --tag architecture \
41
+ "Discovered that the auth service uses JWT with RS256"
42
+
43
+ # Search memory
44
+ awp memory search "auth"
45
+ ```
46
+
47
+ ### Artifacts (SMP)
48
+
49
+ Versioned knowledge documents with provenance tracking and confidence scores.
50
+
51
+ ```bash
52
+ # Create a new artifact
53
+ awp artifact create llm-research --title "LLM Context Research" --tags ai,research
54
+
55
+ # Edit the markdown body, then commit the change
56
+ awp artifact commit llm-research -m "Added benchmark comparison"
57
+
58
+ # List all artifacts
59
+ awp artifact list
60
+
61
+ # Filter by tag
62
+ awp artifact list --tag ai
63
+
64
+ # Search content, titles, and tags
65
+ awp artifact search "context window"
66
+
67
+ # View provenance history
68
+ awp artifact log llm-research
69
+
70
+ # Merge one artifact into another (additive)
71
+ awp artifact merge target-slug source-slug
72
+ ```
73
+
74
+ ## What It Creates
75
+
76
+ ```
77
+ your-agent/
78
+ .awp/workspace.json # Workspace manifest
79
+ IDENTITY.md # Who the agent is
80
+ SOUL.md # How the agent behaves
81
+ USER.md # Human profile
82
+ memory/ # Structured daily logs
83
+ artifacts/ # Knowledge artifacts
84
+ ```
85
+
86
+ Every file is valid Markdown with structured YAML frontmatter — human-readable and machine-parseable.
87
+
88
+ ## Part of AWP
89
+
90
+ This package is part of the [Agent Workspace Protocol](https://github.com/marcoloco23/awp) monorepo:
91
+
92
+ | Package | Description |
93
+ |---------|-------------|
94
+ | [@agent-workspace/core](https://www.npmjs.com/package/@agent-workspace/core) | Types, constants, JSON schemas |
95
+ | **@agent-workspace/cli** | CLI tool |
96
+ | [@agent-workspace/mcp-server](https://www.npmjs.com/package/@agent-workspace/mcp-server) | MCP server |
97
+
98
+ ## License
99
+
100
+ Apache-2.0
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@agent-workspace/cli",
3
- "version": "0.2.0",
3
+ "version": "0.2.1",
4
4
  "description": "CLI for the Agent Workspace Protocol — init, validate, inspect, and manage agent workspaces",
5
5
  "license": "Apache-2.0",
6
6
  "type": "module",
@@ -37,7 +37,7 @@
37
37
  "prepublishOnly": "npm run build"
38
38
  },
39
39
  "dependencies": {
40
- "@agent-workspace/core": "0.2.0",
40
+ "@agent-workspace/core": "0.2.1",
41
41
  "ajv": "^8.17.0",
42
42
  "ajv-formats": "^3.0.1",
43
43
  "commander": "^13.0.0",