@openweave/weave-cli 1.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 lemur bookstores
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,116 @@
+# ⌨️ Weave CLI
+
+> Command-line interface for OpenWeave intelligent agent framework
+
+## Overview
+
+**Weave CLI** is the command-line tool for interacting with OpenWeave locally. It provides commands to scaffold projects, track progress, and manage the agent's knowledge graph.
+
+## Installation
+
+```bash
+npm install -g @openweave/weave-cli
+```
+
+Or use directly with npx:
+
+```bash
+npx @openweave/weave-cli --help
+```
+
+## Commands
+
+### `weave init <project>`
+
+Initialize a new OpenWeave project session.
+
+```bash
+weave init my-project
+# Creates:
+# - my-project/.weave/context.json (knowledge graph state)
+# - my-project/ROADMAP.md (milestone tracker)
+```
+
+### `weave status`
+
+Show current project status and milestones.
+
+```bash
+weave status
+# Output:
+# 🗺️ OpenWeave Project Status
+# M1 · WeaveGraph Core        [✅ 100%]
+# M2 · WeaveLint Core          [🔄 50%]
+# M3 · WeavePath Core          [🔜 0%]
+```
+
+### `weave milestones`
+
+List all milestones and sub-tasks.
+
+```bash
+weave milestones
+# Shows detailed breakdown of all milestones
+```
+
+### `weave errors`
+
+List error registry and correction patterns.
+
+```bash
+weave errors
+# Shows common errors encountered and corrections applied
+```
+
+### `weave query <term>`
+
+Search the knowledge graph.
+
+```bash
+weave query "authentication system"
+# Returns nodes matching the query with relevance scores
+```
+
+### `weave save-node`
+
+Manually add a node to the knowledge graph.
+
+```bash
+weave save-node --label "API Design Decision" --type DECISION
+```
+
+### `weave orphans`
+
+Run code orphan detection on current project.
+
+```bash
+weave orphans --path ./src
+# Shows unused functions, classes, and modules
+```
+
+## Configuration
+
+Weave CLI uses `.weave/config.json` for project settings:
+
+```json
+{
+  "project_name": "my-project",
+  "knowledge_graph_path": ".weave/context.json",
+  "roadmap_file": "ROADMAP.md",
+  "include_tests": false,
+  "max_context_depth": 2
+}
+```
+
+## Environment Variables
+
+- `WEAVE_PROJECT_ROOT` — Override project root directory
+- `WEAVE_VERBOSE` — Enable verbose logging
+- `WEAVE_DEBUG` — Enable debug mode
+
+## Related Packages
+
+- **@openweave/weave-graph** — Knowledge graph storage and retrieval
+- **@openweave/weave-lint** — Code orphan detection
+- **@openweave/weave-path** — Milestone planning
+- **@openweave/weave-link** — MCP server for integrations

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@openweave/weave-cli",
+  "version": "1.0.2",
+  "description": "Weave CLI - Command-line interface for OpenWeave agent framework",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "weave": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "keywords": [
+    "openweave",
+    "cli",
+    "agent",
+    "planning"
+  ],
+  "author": "OpenWeave Team",
+  "license": "MIT",
+  "private": false,
+  "dependencies": {
+    "@openweave/weave-provider": "0.8.0",
+    "@openweave/weave-graph": "0.2.0",
+    "@openweave/weave-tools": "1.0.0",
+    "@openweave/weave-path": "0.2.0",
+    "@openweave/weave-skills": "1.0.0",
+    "@openweave/weave-lint": "0.2.0",
+    "@openweave/weave-link": "0.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "22.10.1",
+    "typescript": "5.7.2",
+    "vitest": "3.0.0",
+    "tsx": "4.7.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/cli.ts",
+    "test": "vitest --no-coverage",
+    "cli": "node dist/cli.js"
+  }
+}