AGENTS.md

1# src/cli/config-manager/ — CLI Installation Utilities
2 
3**Generated:** 2026-05-15
4 
5## OVERVIEW
6 
720 files. Stateless utility functions for the `install` command. Handles OpenCode config manipulation, provider configuration, JSONC operations, binary detection, and npm registry queries. No class — flat utility collection.
8 
9## FILE CATALOG
10 
11| File | Purpose |
12|------|---------|
13| `add-plugin-to-opencode-config.ts` | Register `oh-my-opencode` in `.opencode/opencode.json` plugin array |
14| `add-provider-config.ts` | Add provider API key to OpenCode config (user-level) |
15| `antigravity-provider-configuration.ts` | Handle Antigravity provider setup (special case) |
16| `auth-plugins.ts` | Detect auth plugin requirements per provider (oauth vs key) |
17| `bun-install.ts` | Run `bun install` / `npm install` for plugin setup |
18| `config-context.ts` | `ConfigContext` — shared config state across install steps |
19| `deep-merge-record.ts` | Deep merge utility for JSONC config objects |
20| `detect-current-config.ts` | Read existing OpenCode config, detect installed plugins |
21| `ensure-config-directory-exists.ts` | Create `.opencode/` dir if missing |
22| `format-error-with-suggestion.ts` | Format errors with actionable suggestions |
23| `generate-omo-config.ts` | Generate the `[opencode]` OMO view from install selections |
24| `jsonc-provider-editor.ts` | Read/write JSONC files with comment preservation |
25| `npm-dist-tags.ts` | Fetch latest version from npm registry (dist-tags) |
26| `opencode-binary.ts` | Detect OpenCode binary location, verify it's installed |
27| `opencode-config-format.ts` | OpenCode config format constants and type guards |
28| `parse-opencode-config-file.ts` | Parse opencode.json/opencode.jsonc with fallback |
29| `plugin-name-with-version.ts` | Resolve `oh-my-opencode@X.Y.Z` for installation |
30| `write-omo-config.ts` | Write generated config to `~/.omo/omo.jsonc` |
31 
32## USAGE PATTERN
33 
34Functions are called sequentially by `src/cli/install.ts` / `src/cli/tui-installer.ts`:
35 
36```
371. ensure-config-directory-exists
382. detect-current-config (check what's already set up)
393. opencode-binary (verify opencode installed)
404. npm-dist-tags (get latest version)
415. generate-omo-config (build config from user selections)
426. write-omo-config
437. add-plugin-to-opencode-config
448. add-provider-config (for each provider selected)
459. bun-install
46```
47 
48## NOTES
49 
50- All functions are pure / stateless (except disk I/O) — no shared module state
51- `jsonc-provider-editor.ts` uses comment-preserving JSONC library — NEVER use `JSON.parse` on JSONC files
52- `opencode-binary.ts` searches PATH + common install locations (`.local/bin`, `~/.bun/bin`, etc.)
53