vibe-weaver 1.0.0

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/README.md ADDED
@@ -0,0 +1,229 @@
1
+ # Vibe-Weaver CLI
2
+
3
+ A production-ready terminal agent that beats Claude Code.
4
+
5
+ ## Installation
6
+
7
+ ```bash
8
+ # Install globally via npm
9
+ npm install -g vibe-weaver
10
+
11
+ # Or run via npx (no install needed)
12
+ npx vibe-weaver <command>
13
+ ```
14
+
15
+ ## Authentication
16
+
17
+ ### Login with API Key
18
+
19
+ ```bash
20
+ # Interactive login (prompts for API key)
21
+ vibe-weaver login
22
+
23
+ # Or provide API key directly
24
+ vibe-weaver login --api-key vw_your_api_key
25
+
26
+ # Open browser to create API key
27
+ vibe-weaver login --open
28
+ ```
29
+
30
+ ### Login with GitHub Token
31
+
32
+ ```bash
33
+ vibe-weaver login --github
34
+ ```
35
+
36
+ ### Check Login Status
37
+
38
+ ```bash
39
+ vibe-weaver whoami
40
+ ```
41
+
42
+ ### Logout
43
+
44
+ ```bash
45
+ vibe-weaver logout
46
+ ```
47
+
48
+ ## Commands
49
+
50
+ ### Code Generation
51
+
52
+ ```bash
53
+ # Generate code with all options
54
+ vibe-weaver generate --goal "Create a React todo app" --platform web --mode balanced
55
+
56
+ # One-shot generation with output directory
57
+ vibe-weaver generate --goal "Create a REST API" --platform api --language typescript --out ./src
58
+ ```
59
+
60
+ Options:
61
+ - `-g, --goal <text>` - Goal/prompt for code generation (required)
62
+ - `-p, --platform <type>` - Platform: web, roblox, mobile, desktop, api (default: web)
63
+ - `-l, --language <lang>` - Language: typescript, javascript, python, lua, rust (default: typescript)
64
+ - `-m, --mode <mode>` - Model: fast, balanced, deep_reasoning, refactor (default: balanced)
65
+ - `-o, --out <dir>` - Output directory (default: .)
66
+ - `-y, --yes` - Auto-approve file writes
67
+ - `-d, --dry-run` - Preview without writing
68
+
69
+ ### Interactive Agent
70
+
71
+ ```bash
72
+ # Start interactive REPL
73
+ vibe-weaver run
74
+
75
+ # With auto-approval
76
+ vibe-weaver run --yes
77
+ ```
78
+
79
+ ### File Operations
80
+
81
+ ```bash
82
+ # Read a file
83
+ vibe-weaver read src/App.tsx
84
+
85
+ # Write a file
86
+ vibe-weaver write src/index.js "console.log('hello')"
87
+
88
+ # List directory
89
+ vibe-weaver ls src
90
+
91
+ # Search in files
92
+ vibe-weaver grep "function" --recursive
93
+ ```
94
+
95
+ ### Shell Execution
96
+
97
+ ```bash
98
+ # Execute any shell command
99
+ vibe-weaver exec "npm run build"
100
+
101
+ # Dry run
102
+ vibe-weaver exec "rm -rf node_modules" --dry-run
103
+ ```
104
+
105
+ ### Git Operations
106
+
107
+ ```bash
108
+ # Show git status
109
+ vibe-weaver status
110
+
111
+ # Commit changes
112
+ vibe-weaver commit "feat: add new feature"
113
+ vibe-weaver commit -a "fix: bug fix"
114
+
115
+ # Push to remote
116
+ vibe-weaver push
117
+ vibe-weaver push --force
118
+
119
+ # Pull from remote
120
+ vibe-weaver pull
121
+ ```
122
+
123
+ ### Pull Requests
124
+
125
+ ```bash
126
+ # Create PR with AI-generated summary
127
+ vibe-weaver pr
128
+
129
+ # With specific options
130
+ vibe-weaver pr --owner myorg --repo myrepo --title "My PR" --base main
131
+ ```
132
+
133
+ ### Build & Install
134
+
135
+ ```bash
136
+ # Run install (detects package manager)
137
+ vibe-weaver install
138
+
139
+ # Run build
140
+ vibe-weaver build
141
+
142
+ # Dry run
143
+ vibe-weaver install --dry-run
144
+ vibe-weaver build --dry-run
145
+ ```
146
+
147
+ ## Credit System
148
+
149
+ Each model mode has a credit cost:
150
+
151
+ | Mode | Cost |
152
+ |------|------|
153
+ | fast | 0.2 credits |
154
+ | balanced | 0.5 credits |
155
+ | deep_reasoning | 1.0 credits |
156
+ | refactor | 1.0 credits |
157
+
158
+ Check your credits with `vibe-weaver whoami`.
159
+
160
+ ## Beyond Claude Code
161
+
162
+ Vibe-Weaver CLI goes beyond what Claude Code offers:
163
+
164
+ ### 1. MCP Client Built-in
165
+ Connect to Vibe-Weaver's hosted MCP servers and third-party MCP servers:
166
+
167
+ ```bash
168
+ # List available MCP servers
169
+ vibe-weaver mcp --list
170
+
171
+ # Connect to MCP servers
172
+ vibe-weaver mcp --connect
173
+
174
+ # Check status
175
+ vibe-weaver mcp --status
176
+ ```
177
+
178
+ ### 2. Sub-agent Swarm
179
+ Run multiple agents in parallel for complex tasks:
180
+
181
+ ```bash
182
+ # Run swarm with 3 parallel agents
183
+ vibe-weaver swarm --goal "Build a full-stack app" --parallel 3
184
+ ```
185
+
186
+ ### 3. Background Tasks
187
+ Submit server-side runs and check status:
188
+
189
+ ```bash
190
+ # Submit background task
191
+ vibe-weaver task submit --goal "Build the entire project"
192
+
193
+ # Check status
194
+ vibe-weaver task status <id>
195
+
196
+ # Stream logs
197
+ vibe-weaver task logs <id>
198
+
199
+ # Wait for completion
200
+ vibe-weaver task wait <id>
201
+ ```
202
+
203
+ ### 4. Deploy from Terminal
204
+ Deploy and verify:
205
+
206
+ ```bash
207
+ # Deploy with local build
208
+ vibe-weaver deploy --cwd ./my-project --verify
209
+
210
+ # Deploy existing project
211
+ vibe-weaver deploy --project-id <id>
212
+ ```
213
+
214
+ ## Configuration
215
+
216
+ Credentials are stored securely:
217
+ - **Primary**: OS keychain (via keytar)
218
+ - **Fallback**: `~/.vibe-weaver/config.json` (chmod 600)
219
+
220
+ ## Security
221
+
222
+ - Never log tokens or API keys
223
+ - All generation calls go through the Vibe-Weaver API
224
+ - The CLI only holds the user's API key and GitHub token
225
+ - Respect `.gitignore` - never upload secrets
226
+
227
+ ## License
228
+
229
+ MIT
@@ -0,0 +1,8 @@
1
+ #!/usr/bin/env node
2
+
3
+ /**
4
+ * Vibe-Weaver CLI Entry Point
5
+ * This file is the actual executable run when users invoke `vibe-weaver`
6
+ */
7
+
8
+ import '../index.js';
@@ -0,0 +1,8 @@
1
+ #!/usr/bin/env node
2
+
3
+ /**
4
+ * Vibe-Weaver CLI Entry Point
5
+ * This file is the actual executable run when users invoke `vibe-weaver`
6
+ */
7
+
8
+ import '../index.js';
@@ -0,0 +1,2 @@
1
+
2
+ export { }