@networkbase/cli 0.0.0-stage → 1.0.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 (3) hide show
  1. package/README.md +54 -2
  2. package/bin/nb.mjs +4818 -0
  3. package/package.json +34 -4
package/README.md CHANGED
@@ -1,3 +1,55 @@
1
- # Temporary Holding Version
1
+ # @networkbase/cli (`nb`)
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ The official command-line interface, local workspace mirror, Git credential helper, and Model Context Protocol (MCP) server for [NetworkBase](https://networkbase.in).
4
+
5
+ ## Quick Start
6
+
7
+ Run instantly without global installation:
8
+
9
+ ```bash
10
+ npx @networkbase/cli init
11
+ ```
12
+
13
+ Or install globally:
14
+
15
+ ```bash
16
+ npm install -g @networkbase/cli
17
+ nb init
18
+ ```
19
+
20
+ ## Key Capabilities
21
+
22
+ - **Interactive Command Palette & Auth:** 1-click browser PKCE authorization with arrow-key navigation, terminal fuzzy search, and automatic Personal Access Token (PAT) lifecycle.
23
+ - **Sub-Second Fast-Push (1-RTT):** SHA-256 deduplicated, parallelized pushes with `HTTP 304` ETag fast-path.
24
+ - **Local Mirror & Background Daemon:** Zero-prompt local mirror (`.networkbase/mirror/`) with background auto-sync (`nb watch --daemon-worker`) for seamless pair programming with Claude Code, Cursor, and Antigravity.
25
+ - **Task Intelligence & Context Engine:** Real-time task dashboard (`nb task`), task-number binding (`nb task work #4`), interactive subtask checklists (`nb task check`), and live zero-prompt task briefings (`.networkbase/tasks/TASKS.md`).
26
+ - **AI MCP Server:** Plug directly into Cursor, Claude Desktop, or Antigravity via `nb mcp` or stdio transport.
27
+
28
+ ## Commands
29
+
30
+ ```bash
31
+ # Setup & Authentication
32
+ nb init # Interactive setup & workspace linker
33
+ nb auth login # Browser PKCE login or token login
34
+ nb auth status # Check current user and linked workspace
35
+
36
+ # Workspaces & Tasks
37
+ nb workspace list # List all accessible workspaces
38
+ nb task # View active tasks, subtasks & attached files
39
+ nb task 4 # View complete briefing for task #4
40
+ nb task work 4 # Bind task #4 and auto-mirror its attached files
41
+ nb task check # Interactive checklist to toggle subtasks
42
+
43
+ # Files & Sync
44
+ nb sync # Fast-path pull & push synchronization
45
+ nb push [file] # Push changes with sub-second finalization
46
+ nb push [file] --deliverable # Push final deliverable and link to task
47
+ nb watch # Watch local mirror and auto-push changes
48
+
49
+ # AI Integrations
50
+ nb mcp # Start Model Context Protocol server
51
+ ```
52
+
53
+ ## Documentation
54
+
55
+ Full documentation is available at [networkbase.in](https://networkbase.in).