gemkit-cli 0.1.0 → 0.2.2

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 +109 -68
  2. package/dist/index.js +3552 -45
  3. package/package.json +11 -4
package/README.md CHANGED
@@ -1,69 +1,110 @@
1
- # GemKit CLI
2
-
3
- A command-line interface for working with Gemini AI agents, plans, and sessions.
4
-
5
- ## Installation
6
-
7
- ```bash
8
- npm install -g gemkit-cli
9
- ```
10
-
11
- ## Usage
12
-
13
- ```bash
14
- gk <command> [options]
15
- ```
16
-
17
- ### Global Options
18
-
19
- - `--verbose` - Enable verbose output
20
- - `--json` - Output as JSON
21
- - `--help` - Show help
22
- - `--version` - Show version
23
-
24
- ### Commands
25
-
26
- | Command | Description |
27
- |---------|-------------|
28
- | `gk init` | Initialize GemKit in your project |
29
- | `gk new` | Create new agents, plans, or skills |
30
- | `gk agent` | Manage and spawn AI agents |
31
- | `gk session` | View and manage sessions |
32
- | `gk plan` | Work with execution plans |
33
- | `gk tokens` | Analyze token usage and costs |
34
- | `gk config` | Manage configuration |
35
- | `gk cache` | Manage local cache |
36
- | `gk update` | Update GemKit components |
37
- | `gk versions` | Show available versions |
38
- | `gk doctor` | Diagnose issues |
39
- | `gk extension` | Manage extensions |
40
- | `gk catalog` | Browse available kits |
41
- | `gk convert` | Convert between formats |
42
- | `gk paste-image` | Handle image pasting |
43
-
44
- ## Quick Start
45
-
46
- ```bash
47
- # Initialize in your project
48
- gk init
49
-
50
- # Spawn an agent
51
- gk agent spawn "Help me write a function"
52
-
53
- # View session history
54
- gk session list
55
- ```
56
-
57
- ## Requirements
58
-
59
- - Node.js >= 18
60
-
61
- ## Links
62
-
63
- - [Website](https://gemkit.cc)
64
- - [GitHub](https://github.com/therichardngai-code/gemkit-cli)
65
- - [Issues](https://github.com/therichardngai-code/gemkit-cli/issues)
66
-
67
- ## License
68
-
1
+ # GemKit CLI
2
+
3
+ A command-line interface for working with Gemini AI agents, plans, and sessions.
4
+
5
+ ![Demo](public/demo-final.gif)
6
+
7
+ ## Installation
8
+
9
+ ```bash
10
+ npm install -g gemkit-cli
11
+ ```
12
+
13
+ ## Usage
14
+
15
+ ```bash
16
+ gk <command> [options]
17
+ ```
18
+
19
+ ### Global Options
20
+
21
+ - `--verbose` - Enable verbose output
22
+ - `--json` - Output as JSON
23
+ - `--help` - Show help
24
+ - `--version` - Show version
25
+
26
+ ### Commands
27
+
28
+ | Command | Description |
29
+ |---------|-------------|
30
+ | `gk init` | Initialize GemKit in your project |
31
+ | `gk new` | Create new agents, plans, or skills |
32
+ | `gk agent` | Manage and spawn AI agents |
33
+ | `gk office` | Agent Office visualization dashboard |
34
+ | `gk session` | View and manage sessions |
35
+ | `gk plan` | Work with execution plans |
36
+ | `gk tokens` | Analyze token usage and costs |
37
+ | `gk config` | Manage configuration |
38
+ | `gk cache` | Manage local cache |
39
+ | `gk update` | Update GemKit components |
40
+ | `gk versions` | Show available versions |
41
+ | `gk doctor` | Diagnose issues |
42
+ | `gk extension` | Manage extensions |
43
+ | `gk catalog` | Browse available kits |
44
+ | `gk convert` | Convert between formats |
45
+ | `gk paste-image` | Handle image pasting |
46
+
47
+ ### Agent Commands
48
+
49
+ | Command | Description |
50
+ |---------|-------------|
51
+ | `gk agent list` | List all available agent profiles |
52
+ | `gk agent info <name>` | Show agent profile details |
53
+ | `gk agent search "<task>"` | Find best agent+skills for a task |
54
+ | `gk agent spawn -p "<prompt>"` | Spawn a sub-agent |
55
+
56
+ **Spawn Options:**
57
+ - `-a, --agent <name>` - Agent profile name
58
+ - `-s, --skills <list>` - Comma-separated skills to inject
59
+ - `-c, --context <files>` - Context files (@file syntax)
60
+ - `-m, --model <model>` - Model override
61
+ - `--music` - Play elevator music while waiting
62
+
63
+ ### Agent Office Commands
64
+
65
+ | Command | Description |
66
+ |---------|-------------|
67
+ | `gk office start` | Start the web visualization dashboard |
68
+ | `gk office status` | Show current office state |
69
+ | `gk office watch` | Watch office state changes in real-time |
70
+
71
+ **Options:**
72
+ - `-p, --port <n>` - Web server port (default: 3847)
73
+ - `--no-open` - Don't auto-open browser
74
+ - `--json` - Output as JSON
75
+
76
+ ## Quick Start
77
+
78
+ ```bash
79
+ # Initialize in your project
80
+ gk init
81
+
82
+ # Spawn an agent with a task
83
+ gk agent spawn -p "Help me write a function"
84
+
85
+ # Spawn with specific agent profile and skills
86
+ gk agent spawn -a researcher -s "frontend-design" -p "Build a dashboard"
87
+
88
+ # Search for the best agent for a task
89
+ gk agent search "implement user authentication"
90
+
91
+ # Start the Agent Office dashboard
92
+ gk office start
93
+
94
+ # View session history
95
+ gk session list
96
+ ```
97
+
98
+ ## Requirements
99
+
100
+ - Node.js >= 18
101
+
102
+ ## Links
103
+
104
+ - [Website](https://gemkit.cc)
105
+ - [GitHub](https://github.com/therichardngai-code/gemkit-cli)
106
+ - [Issues](https://github.com/therichardngai-code/gemkit-cli/issues)
107
+
108
+ ## License
109
+
69
110
  MIT