@brainfile/cli 0.1.0 → 0.1.3

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 +84 -27
  2. package/package.json +3 -5
package/README.md CHANGED
@@ -4,19 +4,68 @@ Command-line interface for Brainfile task management. Manage your tasks from the
4
4
 
5
5
  ## Installation
6
6
 
7
+ ### Install Globally (Recommended)
8
+
9
+ Install the CLI globally to use the `brainfile` command anywhere:
10
+
7
11
  ```bash
8
12
  npm install -g @brainfile/cli
9
13
  ```
10
14
 
11
- Or use directly from the repo:
15
+ After installation, verify it works:
12
16
 
13
17
  ```bash
14
- cd packages/brainfile-cli
15
- npm install
16
- npm run build
17
- node dist/cli.js --help
18
+ brainfile --version
19
+ brainfile --help
18
20
  ```
19
21
 
22
+ ### Install as Project Dependency
23
+
24
+ For project-specific usage:
25
+
26
+ ```bash
27
+ npm install --save-dev @brainfile/cli
28
+ ```
29
+
30
+ Then use via npm scripts or npx:
31
+
32
+ ```bash
33
+ npx brainfile list
34
+ ```
35
+
36
+ ### Using npx (No Installation)
37
+
38
+ Run commands without installing:
39
+
40
+ ```bash
41
+ npx @brainfile/cli list
42
+ npx @brainfile/cli add --title "New task"
43
+ ```
44
+
45
+ ## Quick Start
46
+
47
+ 1. **Install the CLI:**
48
+ ```bash
49
+ npm install -g @brainfile/cli
50
+ ```
51
+
52
+ 2. **Create a brainfile.md** in your project (or use an existing one)
53
+
54
+ 3. **List your tasks:**
55
+ ```bash
56
+ brainfile list
57
+ ```
58
+
59
+ 4. **Add a new task:**
60
+ ```bash
61
+ brainfile add --title "My first task" --priority high
62
+ ```
63
+
64
+ 5. **Move a task:**
65
+ ```bash
66
+ brainfile move --task task-123 --column done
67
+ ```
68
+
20
69
  ## Usage
21
70
 
22
71
  ### List Tasks
@@ -235,41 +284,49 @@ Task IDs are automatically generated with a timestamp and random string to ensur
235
284
  - Task completion tracking
236
285
  - Subtask management
237
286
 
238
- ## Development
287
+ ## Package Information
288
+
289
+ - **Package**: `@brainfile/cli`
290
+ - **npm**: https://www.npmjs.com/package/@brainfile/cli
291
+ - **Repository**: https://github.com/brainfile/cli
292
+ - **Core Library**: Built on [@brainfile/core](https://www.npmjs.com/package/@brainfile/core)
239
293
 
240
- ### Using Make (Recommended)
294
+ ## Development
241
295
 
242
- From the project root:
296
+ ### Setup
243
297
 
244
298
  ```bash
245
- # Build the CLI (includes core library)
246
- make build-cli
299
+ # Clone the repository
300
+ git clone https://github.com/brainfile/cli.git
301
+ cd cli
247
302
 
248
- # Run the CLI with automatic build (fast dev shortcut)
249
- make cli ARGS="list --file brainfile.md"
250
- make cli ARGS="add --title 'New task' --priority high"
251
- make cli ARGS="--help"
303
+ # Install dependencies
304
+ npm install
305
+
306
+ # Build
307
+ npm run build
252
308
 
253
- # Create standalone binaries for distribution
254
- make build-cli-bin
309
+ # Run tests
310
+ npm test
255
311
 
256
- # Clean all build artifacts
257
- make clean
312
+ # Watch mode for development
313
+ npm run dev
258
314
  ```
259
315
 
260
- ### Using npm directly
261
-
262
- From the `packages/brainfile-cli` directory:
316
+ ### Testing Locally
263
317
 
264
318
  ```bash
265
- # Install dependencies
266
- npm install
267
-
268
- # Build
319
+ # Build the CLI
269
320
  npm run build
270
321
 
271
- # Watch mode
272
- npm run dev
322
+ # Link globally for local testing
323
+ npm link
324
+
325
+ # Now you can use it anywhere
326
+ brainfile --help
327
+
328
+ # Unlink when done
329
+ npm unlink -g @brainfile/cli
273
330
  ```
274
331
 
275
332
  ## License
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@brainfile/cli",
3
- "version": "0.1.0",
3
+ "version": "0.1.3",
4
4
  "description": "Command-line interface for Brainfile task management",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/index.d.ts",
@@ -15,8 +15,7 @@
15
15
  "test:watch": "jest --watch",
16
16
  "test:coverage": "jest --coverage",
17
17
  "prepublishOnly": "npm run build",
18
- "prepack": "npm run build",
19
- "version": "npm run build && git add -A dist"
18
+ "prepack": "npm run build"
20
19
  },
21
20
  "keywords": [
22
21
  "brainfile",
@@ -28,8 +27,7 @@
28
27
  "license": "MIT",
29
28
  "repository": {
30
29
  "type": "git",
31
- "url": "https://github.com/brainfile/brainfile",
32
- "directory": "cli"
30
+ "url": "https://github.com/brainfile/cli"
33
31
  },
34
32
  "publishConfig": {
35
33
  "access": "public"