zenox 0.1.0 → 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 CHANGED
@@ -6,22 +6,54 @@ OpenCode plugin for intelligent agent orchestration with specialized subagents a
6
6
 
7
7
  - **4 Specialized Subagents**: Explorer, Librarian, Oracle, UI-Planner
8
8
  - **Background Tasks**: Parallel agent execution for comprehensive research
9
+ - **Auto-Update**: Automatic update checking with toast notifications
9
10
  - **Auto-Loaded MCP Servers**: exa, grep_app, sequential-thinking
10
11
  - **Smart Orchestration**: Automatically teaches Build/Plan agents how to delegate
11
- - **Portable**: Install on any machine via opencode.json
12
+ - **CLI Installer**: Easy setup via `bunx zenox install`
12
13
 
13
14
  ## Installation
14
15
 
16
+ ### Quick Install (Recommended)
17
+
18
+ ```bash
19
+ bunx zenox install
20
+ ```
21
+
22
+ This will:
23
+ - Create `opencode.json` if it doesn't exist
24
+ - Add zenox to your plugins array
25
+ - Preserve existing configuration
26
+
27
+ ### Manual Install
28
+
15
29
  Add to your `opencode.json`:
16
30
 
17
31
  ```json
18
32
  {
19
- "plugin": ["zenox@0.1.0"]
33
+ "plugins": ["zenox"]
20
34
  }
21
35
  ```
22
36
 
37
+ > **Note**: Don't pin the version (e.g., `zenox@0.1.0`) if you want automatic updates.
38
+
23
39
  Restart OpenCode and the plugin is ready to use.
24
40
 
41
+ ## CLI Commands
42
+
43
+ ```bash
44
+ # Interactive install with TUI
45
+ bunx zenox install
46
+
47
+ # Non-interactive mode (CI/scripts)
48
+ bunx zenox install --no-tui
49
+
50
+ # Specify config path
51
+ bunx zenox install --config ./path/to/opencode.json
52
+
53
+ # Help
54
+ bunx zenox --help
55
+ ```
56
+
25
57
  ## Agents
26
58
 
27
59
  ### @explorer
@@ -81,6 +113,17 @@ background_output(task_id="bg_abc123")
81
113
  | Codebase + external docs | YES - explore + librarian in parallel |
82
114
  | Result A needed before B | NO - use sequential Task |
83
115
 
116
+ ## Auto-Update
117
+
118
+ Zenox automatically checks for updates on startup:
119
+
120
+ 1. **Startup Toast**: Shows current version when plugin loads
121
+ 2. **Update Check**: Queries npm registry for latest version
122
+ 3. **Cache Invalidation**: If update available, clears Bun cache
123
+ 4. **Update Toast**: Notifies you to restart OpenCode
124
+
125
+ To disable auto-updates, pin your version: `"zenox@0.1.0"`
126
+
84
127
  ## Configuration (Optional)
85
128
 
86
129
  Create `~/.config/opencode/zenox.json` or `.opencode/zenox.json`:
@@ -0,0 +1,13 @@
1
+ import type { OpencodeConfig, ConfigFormat } from "./types";
2
+ export declare function findConfigFile(directory: string): {
3
+ path: string;
4
+ format: ConfigFormat;
5
+ } | null;
6
+ export declare function readConfig(configPath: string): Promise<{
7
+ content: string;
8
+ config: OpencodeConfig;
9
+ }>;
10
+ export declare function isPluginInstalled(config: OpencodeConfig): boolean;
11
+ export declare function installPlugin(configPath: string): Promise<void>;
12
+ export declare function getDefaultConfigPath(directory: string): string;
13
+ export declare function createDefaultConfig(configPath: string): Promise<void>;
@@ -0,0 +1,2 @@
1
+ #!/usr/bin/env node
2
+ export {};