@oh-my-pi/pi-coding-agent 2.3.1337 → 3.1.1337
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/CHANGELOG.md +72 -34
- package/README.md +100 -100
- package/docs/compaction.md +8 -8
- package/docs/config-usage.md +113 -0
- package/docs/custom-tools.md +8 -8
- package/docs/extension-loading.md +58 -58
- package/docs/hooks.md +11 -11
- package/docs/rpc.md +4 -4
- package/docs/sdk.md +14 -14
- package/docs/session-tree-plan.md +1 -1
- package/docs/session.md +2 -2
- package/docs/skills.md +16 -16
- package/docs/theme.md +9 -9
- package/docs/tui.md +1 -1
- package/examples/README.md +1 -1
- package/examples/custom-tools/README.md +4 -4
- package/examples/custom-tools/subagent/README.md +13 -13
- package/examples/custom-tools/subagent/agents.ts +2 -2
- package/examples/custom-tools/subagent/index.ts +5 -5
- package/examples/hooks/README.md +3 -3
- package/examples/hooks/auto-commit-on-exit.ts +1 -1
- package/examples/hooks/custom-compaction.ts +1 -1
- package/examples/sdk/01-minimal.ts +1 -1
- package/examples/sdk/04-skills.ts +1 -1
- package/examples/sdk/05-tools.ts +1 -1
- package/examples/sdk/08-slash-commands.ts +1 -1
- package/examples/sdk/09-api-keys-and-oauth.ts +2 -2
- package/examples/sdk/README.md +2 -2
- package/package.json +13 -11
- package/src/capability/context-file.ts +40 -0
- package/src/capability/extension.ts +48 -0
- package/src/capability/hook.ts +40 -0
- package/src/capability/index.ts +616 -0
- package/src/capability/instruction.ts +37 -0
- package/src/capability/mcp.ts +52 -0
- package/src/capability/prompt.ts +35 -0
- package/src/capability/rule.ts +52 -0
- package/src/capability/settings.ts +35 -0
- package/src/capability/skill.ts +49 -0
- package/src/capability/slash-command.ts +40 -0
- package/src/capability/system-prompt.ts +35 -0
- package/src/capability/tool.ts +38 -0
- package/src/capability/types.ts +166 -0
- package/src/cli/args.ts +2 -2
- package/src/cli/plugin-cli.ts +24 -19
- package/src/cli/update-cli.ts +10 -10
- package/src/config.ts +290 -6
- package/src/core/auth-storage.ts +32 -9
- package/src/core/bash-executor.ts +1 -1
- package/src/core/custom-commands/loader.ts +44 -50
- package/src/core/custom-tools/index.ts +1 -0
- package/src/core/custom-tools/loader.ts +67 -69
- package/src/core/custom-tools/types.ts +10 -1
- package/src/core/hooks/loader.ts +13 -42
- package/src/core/index.ts +0 -1
- package/src/core/logger.ts +7 -7
- package/src/core/mcp/client.ts +1 -1
- package/src/core/mcp/config.ts +94 -146
- package/src/core/mcp/index.ts +0 -4
- package/src/core/mcp/loader.ts +26 -22
- package/src/core/mcp/manager.ts +18 -23
- package/src/core/mcp/tool-bridge.ts +9 -1
- package/src/core/mcp/types.ts +2 -0
- package/src/core/model-registry.ts +25 -8
- package/src/core/plugins/installer.ts +1 -1
- package/src/core/plugins/loader.ts +17 -11
- package/src/core/plugins/manager.ts +2 -2
- package/src/core/plugins/paths.ts +12 -7
- package/src/core/plugins/types.ts +3 -3
- package/src/core/sdk.ts +48 -27
- package/src/core/session-manager.ts +4 -4
- package/src/core/settings-manager.ts +45 -21
- package/src/core/skills.ts +208 -293
- package/src/core/slash-commands.ts +34 -165
- package/src/core/system-prompt.ts +58 -65
- package/src/core/timings.ts +2 -2
- package/src/core/tools/lsp/config.ts +38 -17
- package/src/core/tools/task/agents.ts +21 -0
- package/src/core/tools/task/artifacts.ts +1 -1
- package/src/core/tools/task/bundled-agents/reviewer.md +2 -1
- package/src/core/tools/task/bundled-agents/task.md +1 -0
- package/src/core/tools/task/commands.ts +30 -107
- package/src/core/tools/task/discovery.ts +75 -66
- package/src/core/tools/task/executor.ts +25 -10
- package/src/core/tools/task/index.ts +35 -10
- package/src/core/tools/task/model-resolver.ts +27 -25
- package/src/core/tools/task/types.ts +6 -2
- package/src/core/tools/web-fetch.ts +3 -3
- package/src/core/tools/web-search/auth.ts +40 -34
- package/src/core/tools/web-search/index.ts +1 -1
- package/src/core/tools/web-search/providers/anthropic.ts +1 -1
- package/src/discovery/agents-md.ts +75 -0
- package/src/discovery/builtin.ts +646 -0
- package/src/discovery/claude.ts +623 -0
- package/src/discovery/cline.ts +102 -0
- package/src/discovery/codex.ts +571 -0
- package/src/discovery/cursor.ts +264 -0
- package/src/discovery/gemini.ts +368 -0
- package/src/discovery/github.ts +120 -0
- package/src/discovery/helpers.test.ts +127 -0
- package/src/discovery/helpers.ts +249 -0
- package/src/discovery/index.ts +84 -0
- package/src/discovery/mcp-json.ts +127 -0
- package/src/discovery/vscode.ts +99 -0
- package/src/discovery/windsurf.ts +216 -0
- package/src/main.ts +14 -13
- package/src/migrations.ts +24 -3
- package/src/modes/interactive/components/hook-editor.ts +1 -1
- package/src/modes/interactive/components/plugin-settings.ts +1 -1
- package/src/modes/interactive/components/settings-defs.ts +38 -2
- package/src/modes/interactive/components/settings-selector.ts +1 -0
- package/src/modes/interactive/components/welcome.ts +2 -2
- package/src/modes/interactive/interactive-mode.ts +233 -16
- package/src/modes/interactive/theme/theme-schema.json +1 -1
- package/src/utils/clipboard.ts +1 -1
- package/src/utils/shell-snapshot.ts +2 -2
- package/src/utils/shell.ts +7 -7
package/CHANGELOG.md
CHANGED
|
@@ -2,6 +2,44 @@
|
|
|
2
2
|
|
|
3
3
|
## [Unreleased]
|
|
4
4
|
|
|
5
|
+
## [3.1.1337] - 2026-01-03
|
|
6
|
+
### Added
|
|
7
|
+
|
|
8
|
+
- Added `spawns` frontmatter field for agent definitions to control which sub-agents can be spawned
|
|
9
|
+
- Added spawn restriction enforcement preventing agents from spawning unauthorized sub-agents
|
|
10
|
+
|
|
11
|
+
### Fixed
|
|
12
|
+
|
|
13
|
+
- Fixed duplicate skill loading when the same SKILL.md file was discovered through multiple paths
|
|
14
|
+
|
|
15
|
+
## [3.0.1337] - 2026-01-03
|
|
16
|
+
|
|
17
|
+
### Added
|
|
18
|
+
|
|
19
|
+
- Added unified capability-based discovery system for loading configuration from multiple AI coding tools (Claude Code, Cursor, Windsurf, Gemini, Codex, Cline, GitHub Copilot, VS Code)
|
|
20
|
+
- Added support for discovering MCP servers, rules, skills, hooks, tools, slash commands, prompts, and context files from tool-specific config directories
|
|
21
|
+
- Added Discovery settings tab in interactive mode to enable/disable individual configuration providers
|
|
22
|
+
- Added provider source attribution showing which tool contributed each configuration item
|
|
23
|
+
- Added support for Cursor MDC rule format with frontmatter (description, globs, alwaysApply)
|
|
24
|
+
- Added support for Windsurf rules from .windsurf/rules/*.md and global_rules.md
|
|
25
|
+
- Added support for Cline rules from .clinerules file or directory
|
|
26
|
+
- Added support for GitHub Copilot instructions with applyTo glob patterns
|
|
27
|
+
- Added support for Gemini extensions and system.md customization files
|
|
28
|
+
- Added support for Codex AGENTS.md and config.toml settings
|
|
29
|
+
- Added automatic migration of `PI_*` environment variables to `OMP_*` equivalents for backwards compatibility
|
|
30
|
+
- Added multi-path config discovery supporting `.omp`, `.pi`, and `.claude` directories with priority ordering
|
|
31
|
+
- Added `getConfigDirPaths()`, `findConfigFile()`, and `readConfigFile()` functions for unified config resolution
|
|
32
|
+
- Added documentation for config module usage patterns
|
|
33
|
+
|
|
34
|
+
### Changed
|
|
35
|
+
|
|
36
|
+
- Changed MCP tool name parsing to use last underscore separator for better server name handling
|
|
37
|
+
- Changed /config output to show provider attribution for discovered items
|
|
38
|
+
- Renamed CLI binary from `pi` to `omp` and updated all command references
|
|
39
|
+
- Changed config directory from `.pi` to `.omp` with fallback support for legacy paths
|
|
40
|
+
- Renamed environment variables from `PI_*` to `OMP_*` prefix (e.g., `OMP_SMOL_MODEL`, `OMP_SLOW_MODEL`)
|
|
41
|
+
- Changed model role alias prefix from `pi/` to `omp/` (e.g., `omp/slow` instead of `pi/slow`)
|
|
42
|
+
|
|
5
43
|
## [2.3.1337] - 2026-01-03
|
|
6
44
|
|
|
7
45
|
## [2.2.1337] - 2026-01-03
|
|
@@ -10,7 +48,7 @@
|
|
|
10
48
|
|
|
11
49
|
### Added
|
|
12
50
|
|
|
13
|
-
- Added `
|
|
51
|
+
- Added `omp update` command to check for and install updates from GitHub releases or via bun
|
|
14
52
|
|
|
15
53
|
### Changed
|
|
16
54
|
|
|
@@ -23,7 +61,7 @@
|
|
|
23
61
|
### Added
|
|
24
62
|
|
|
25
63
|
- Added shell environment snapshot to preserve user aliases, functions, and shell options when executing bash commands
|
|
26
|
-
- Added support for `
|
|
64
|
+
- Added support for `OMP_BASH_NO_CI`, `OMP_BASH_NO_LOGIN`, and `OMP_SHELL_PREFIX` environment variables for shell customization
|
|
27
65
|
- Added zsh support alongside bash for shell detection and configuration
|
|
28
66
|
|
|
29
67
|
### Changed
|
|
@@ -37,7 +75,7 @@
|
|
|
37
75
|
- Added provider tabs to model selector with Tab/Arrow navigation for filtering models by provider
|
|
38
76
|
- Added context menu to model selector for choosing model role (Default, Smol, Slow) instead of keyboard shortcuts
|
|
39
77
|
- Added LSP diagnostics display in tool execution output showing errors and warnings after file edits
|
|
40
|
-
- Added centralized file logger with daily rotation to `~/.
|
|
78
|
+
- Added centralized file logger with daily rotation to `~/.omp/logs/` for debugging production issues
|
|
41
79
|
- Added `logger` property to hook and custom tool APIs for error/warning/debug logging
|
|
42
80
|
- Added `output` tool to read full agent/task outputs by ID when truncated previews are insufficient
|
|
43
81
|
- Added `task` tool to reviewer agent, enabling parallel exploration of large codebases during reviews
|
|
@@ -48,8 +86,8 @@
|
|
|
48
86
|
- Added `explicitTools` option to `createAgentSession` for enabling hidden tools by name
|
|
49
87
|
- Added example review tools (`report_finding`, `submit_review`) with structured findings accumulation and verdict rendering
|
|
50
88
|
- Added `/review` example command for interactive code review with branch comparison, uncommitted changes, and commit review modes
|
|
51
|
-
- Custom TypeScript slash commands: Create programmable commands at `~/.
|
|
52
|
-
- Claude command directories: Markdown slash commands now also load from `~/.claude/commands/` and `.claude/commands/` (parallel to existing `.
|
|
89
|
+
- Custom TypeScript slash commands: Create programmable commands at `~/.omp/agent/commands/[name]/index.ts` or `.omp/commands/[name]/index.ts`. Commands export a factory returning `{ name, description, execute(args, ctx) }`. Return a string to send as LLM prompt, or void for fire-and-forget actions. Full access to `HookCommandContext` for UI dialogs, session control, and shell execution.
|
|
90
|
+
- Claude command directories: Markdown slash commands now also load from `~/.claude/commands/` and `.claude/commands/` (parallel to existing `.omp/commands/` support)
|
|
53
91
|
- `commands.enableClaudeUser` and `commands.enableClaudeProject` settings to disable Claude command directory loading
|
|
54
92
|
- `/export --copy` option to copy entire session as formatted text to clipboard
|
|
55
93
|
|
|
@@ -106,7 +144,7 @@
|
|
|
106
144
|
- Smol model auto-discovery using priority chain: haiku > flash > mini
|
|
107
145
|
- Slow model auto-discovery using priority chain: gpt-5.2-codex > codex > gpt > opus > pro
|
|
108
146
|
- CLI args for model roles: `--smol <model>` and `--slow <model>` (ephemeral, not persisted)
|
|
109
|
-
- Env var overrides: `
|
|
147
|
+
- Env var overrides: `OMP_SMOL_MODEL` and `OMP_SLOW_MODEL`
|
|
110
148
|
- Title generation now uses configured smol model from settings
|
|
111
149
|
- LSP diagnostics on edit: Edit tool can now return LSP diagnostics after editing code files. Disabled by default to avoid noise during multi-edit sequences. Enable via `lsp.diagnosticsOnEdit` setting.
|
|
112
150
|
- LSP workspace diagnostics: New `lsp action=workspace_diagnostics` command checks the entire project for errors. Auto-detects project type and uses appropriate checker (rust-analyzer/cargo for Rust, tsc for TypeScript, go build for Go, pyright for Python).
|
|
@@ -118,7 +156,7 @@
|
|
|
118
156
|
- Edit fuzzy match setting: Added `edit.fuzzyMatch` setting (enabled by default) to control whether the edit tool accepts high-confidence fuzzy matches for whitespace/indentation differences. Toggle via `/settings`.
|
|
119
157
|
- Multi-server LSP diagnostics: Diagnostics now query all applicable language servers for a file type. For TypeScript/JavaScript projects with Biome, this means both type errors (from tsserver) and lint errors (from Biome) are reported together.
|
|
120
158
|
- Comprehensive LSP server configurations for 40+ languages including Rust, Go, Python, Java, Kotlin, Scala, Haskell, OCaml, Elixir, Ruby, PHP, C#, Lua, Nix, and many more. Each server includes sensible defaults for args, settings, and init options.
|
|
121
|
-
- Extended LSP config file search paths: Now searches for `lsp.json`, `.lsp.json` in project root and `.
|
|
159
|
+
- Extended LSP config file search paths: Now searches for `lsp.json`, `.lsp.json` in project root and `.omp/` subdirectory, plus user-level configs in `~/.omp/` and home directory.
|
|
122
160
|
|
|
123
161
|
### Changed
|
|
124
162
|
|
|
@@ -343,8 +381,8 @@ See [docs/custom-tools.md](docs/custom-tools.md) and [examples/custom-tools/](ex
|
|
|
343
381
|
```typescript
|
|
344
382
|
import { discoverAuthStorage, discoverModels } from "@oh-my-pi/pi-coding-agent";
|
|
345
383
|
|
|
346
|
-
const authStorage = discoverAuthStorage(); // ~/.
|
|
347
|
-
const modelRegistry = discoverModels(authStorage); // + ~/.
|
|
384
|
+
const authStorage = discoverAuthStorage(); // ~/.omp/agent/auth.json
|
|
385
|
+
const modelRegistry = discoverModels(authStorage); // + ~/.omp/agent/models.json
|
|
348
386
|
|
|
349
387
|
// Get all models (built-in + custom)
|
|
350
388
|
const allModels = modelRegistry.getAll();
|
|
@@ -479,25 +517,25 @@ Total color count increased from 46 to 50. See [docs/theme.md](docs/theme.md) fo
|
|
|
479
517
|
|
|
480
518
|
### Fixed
|
|
481
519
|
|
|
482
|
-
- **Sessions saved to wrong directory**: In v0.30.0, sessions were being saved to `~/.
|
|
520
|
+
- **Sessions saved to wrong directory**: In v0.30.0, sessions were being saved to `~/.omp/agent/` instead of `~/.omp/agent/sessions/<encoded-cwd>/`, breaking `--resume` and `/resume`. Misplaced sessions are automatically migrated on startup. ([#320](https://github.com/badlogic/pi-mono/issues/320) by [@aliou](https://github.com/aliou))
|
|
483
521
|
- **Custom system prompts missing context**: When using a custom system prompt string, project context files (AGENTS.md), skills, date/time, and working directory were not appended. ([#321](https://github.com/badlogic/pi-mono/issues/321))
|
|
484
522
|
|
|
485
523
|
## [0.30.0] - 2025-12-25
|
|
486
524
|
|
|
487
525
|
### Breaking Changes
|
|
488
526
|
|
|
489
|
-
- **SessionManager API**: The second parameter of `create()`, `continueRecent()`, and `list()` changed from `agentDir` to `sessionDir`. When provided, it specifies the session directory directly (no cwd encoding). When omitted, uses default (`~/.
|
|
527
|
+
- **SessionManager API**: The second parameter of `create()`, `continueRecent()`, and `list()` changed from `agentDir` to `sessionDir`. When provided, it specifies the session directory directly (no cwd encoding). When omitted, uses default (`~/.omp/agent/sessions/<encoded-cwd>/`). `open()` no longer takes `agentDir`. ([#313](https://github.com/badlogic/pi-mono/pull/313))
|
|
490
528
|
|
|
491
529
|
### Added
|
|
492
530
|
|
|
493
|
-
- **`--session-dir` flag**: Use a custom directory for sessions instead of the default `~/.
|
|
531
|
+
- **`--session-dir` flag**: Use a custom directory for sessions instead of the default `~/.omp/agent/sessions/<encoded-cwd>/`. Works with `-c` (continue) and `-r` (resume) flags. ([#313](https://github.com/badlogic/pi-mono/pull/313) by [@scutifer](https://github.com/scutifer))
|
|
494
532
|
- **Reverse model cycling and model selector**: Shift+Ctrl+P cycles models backward, Ctrl+L opens model selector (retaining text in editor). ([#315](https://github.com/badlogic/pi-mono/pull/315) by [@mitsuhiko](https://github.com/mitsuhiko))
|
|
495
533
|
|
|
496
534
|
## [0.29.1] - 2025-12-25
|
|
497
535
|
|
|
498
536
|
### Added
|
|
499
537
|
|
|
500
|
-
- **Automatic custom system prompt loading**:
|
|
538
|
+
- **Automatic custom system prompt loading**: OMP now auto-loads `SYSTEM.md` files to replace the default system prompt. Project-local `.omp/SYSTEM.md` takes precedence over global `~/.omp/agent/SYSTEM.md`. CLI `--system-prompt` flag overrides both. ([#309](https://github.com/badlogic/pi-mono/issues/309))
|
|
501
539
|
- **Unified `/settings` command**: New settings menu consolidating thinking level, theme, queue mode, auto-compact, show images, hide thinking, and collapse changelog. Replaces individual `/thinking`, `/queue`, `/theme`, `/autocompact`, and `/show-images` commands. ([#310](https://github.com/badlogic/pi-mono/issues/310))
|
|
502
540
|
|
|
503
541
|
### Fixed
|
|
@@ -524,7 +562,7 @@ Total color count increased from 46 to 50. See [docs/theme.md](docs/theme.md) fo
|
|
|
524
562
|
|
|
525
563
|
### Changed
|
|
526
564
|
|
|
527
|
-
- **Credential storage refactored**: API keys and OAuth tokens are now stored in `~/.
|
|
565
|
+
- **Credential storage refactored**: API keys and OAuth tokens are now stored in `~/.omp/agent/auth.json` instead of `oauth.json` and `settings.json`. Existing credentials are automatically migrated on first run. ([#296](https://github.com/badlogic/pi-mono/issues/296))
|
|
528
566
|
|
|
529
567
|
- **SDK API changes** ([#296](https://github.com/badlogic/pi-mono/issues/296)):
|
|
530
568
|
|
|
@@ -592,13 +630,13 @@ Total color count increased from 46 to 50. See [docs/theme.md](docs/theme.md) fo
|
|
|
592
630
|
|
|
593
631
|
### Fixed
|
|
594
632
|
|
|
595
|
-
- **Symlinked skill directories**: Skills in symlinked directories (e.g., `~/.
|
|
633
|
+
- **Symlinked skill directories**: Skills in symlinked directories (e.g., `~/.omp/agent/skills/my-skills -> /path/to/skills`) are now correctly discovered and loaded.
|
|
596
634
|
|
|
597
635
|
## [0.27.3] - 2025-12-24
|
|
598
636
|
|
|
599
637
|
### Added
|
|
600
638
|
|
|
601
|
-
- **API keys in settings.json**: Store API keys in `~/.
|
|
639
|
+
- **API keys in settings.json**: Store API keys in `~/.omp/agent/settings.json` under the `apiKeys` field (e.g., `{ "apiKeys": { "anthropic": "sk-..." } }`). Settings keys take priority over environment variables. ([#295](https://github.com/badlogic/pi-mono/issues/295))
|
|
602
640
|
|
|
603
641
|
### Fixed
|
|
604
642
|
|
|
@@ -619,7 +657,7 @@ Total color count increased from 46 to 50. See [docs/theme.md](docs/theme.md) fo
|
|
|
619
657
|
|
|
620
658
|
### Added
|
|
621
659
|
|
|
622
|
-
- **Startup timing instrumentation**: Set `
|
|
660
|
+
- **Startup timing instrumentation**: Set `OMP_TIMING=1` to see startup performance breakdown (interactive mode only).
|
|
623
661
|
|
|
624
662
|
## [0.27.0] - 2025-12-22
|
|
625
663
|
|
|
@@ -649,7 +687,7 @@ Total color count increased from 46 to 50. See [docs/theme.md](docs/theme.md) fo
|
|
|
649
687
|
|
|
650
688
|
- **SDK for programmatic usage**: New `createAgentSession()` factory with full control over model, tools, hooks, skills, session persistence, and settings. Philosophy: "omit to discover, provide to override". Includes 12 examples and comprehensive documentation. ([#272](https://github.com/badlogic/pi-mono/issues/272))
|
|
651
689
|
|
|
652
|
-
- **Project-specific settings**: Settings now load from both `~/.
|
|
690
|
+
- **Project-specific settings**: Settings now load from both `~/.omp/agent/settings.json` (global) and `<cwd>/.omp/settings.json` (project). Project settings override global with deep merge for nested objects. Project settings are read-only (for version control). ([#276](https://github.com/badlogic/pi-mono/pull/276))
|
|
653
691
|
|
|
654
692
|
- **SettingsManager static factories**: `SettingsManager.create(cwd?, agentDir?)` for file-based settings, `SettingsManager.inMemory(settings?)` for testing. Added `applyOverrides()` for programmatic overrides.
|
|
655
693
|
|
|
@@ -669,7 +707,7 @@ Total color count increased from 46 to 50. See [docs/theme.md](docs/theme.md) fo
|
|
|
669
707
|
|
|
670
708
|
- **External editor support**: Press `Ctrl+G` to edit your message in an external editor. Uses `$VISUAL` or `$EDITOR` environment variable. On successful save, the message is replaced; on cancel, the original is kept. ([#266](https://github.com/badlogic/pi-mono/pull/266) by [@aliou](https://github.com/aliou))
|
|
671
709
|
|
|
672
|
-
- **Process suspension**: Press `Ctrl+Z` to suspend
|
|
710
|
+
- **Process suspension**: Press `Ctrl+Z` to suspend omp and return to the shell. Resume with `fg` as usual. ([#267](https://github.com/badlogic/pi-mono/pull/267) by [@aliou](https://github.com/aliou))
|
|
673
711
|
|
|
674
712
|
- **Configurable skills directories**: Added granular control over skill sources with `enableCodexUser`, `enableClaudeUser`, `enableClaudeProject`, `enablePiUser`, `enablePiProject` toggles, plus `customDirectories` and `ignoredSkills` settings. ([#269](https://github.com/badlogic/pi-mono/pull/269) by [@nicobailon](https://github.com/nicobailon))
|
|
675
713
|
|
|
@@ -753,7 +791,7 @@ Total color count increased from 46 to 50. See [docs/theme.md](docs/theme.md) fo
|
|
|
753
791
|
|
|
754
792
|
- **OpenRouter models with colons in IDs**: Fixed parsing of OpenRouter model IDs that contain colons (e.g., `openrouter:meta-llama/llama-4-scout:free`). ([#242](https://github.com/badlogic/pi-mono/pull/242) by [@aliou](https://github.com/aliou))
|
|
755
793
|
|
|
756
|
-
- **Global AGENTS.md loaded twice**: Fixed global AGENTS.md being loaded twice when present in both `~/.
|
|
794
|
+
- **Global AGENTS.md loaded twice**: Fixed global AGENTS.md being loaded twice when present in both `~/.omp/agent/` and the current directory. ([#239](https://github.com/badlogic/pi-mono/pull/239) by [@aliou](https://github.com/aliou))
|
|
757
795
|
|
|
758
796
|
- **Kitty keyboard protocol on Linux**: Fixed keyboard input not working in Ghostty on Linux when Num Lock is enabled. The Kitty protocol includes Caps Lock and Num Lock state in modifier values, which broke key detection. Now correctly masks out lock key bits when matching keyboard shortcuts. ([#243](https://github.com/badlogic/pi-mono/issues/243))
|
|
759
797
|
|
|
@@ -785,13 +823,13 @@ Total color count increased from 46 to 50. See [docs/theme.md](docs/theme.md) fo
|
|
|
785
823
|
|
|
786
824
|
### Fixed
|
|
787
825
|
|
|
788
|
-
- **JSON mode stdout flush**: Fixed race condition where `
|
|
826
|
+
- **JSON mode stdout flush**: Fixed race condition where `omp --mode json` could exit before all output was written to stdout, causing consumers to miss final events.
|
|
789
827
|
|
|
790
828
|
- **Symlinked tools, hooks, and slash commands**: Discovery now correctly follows symlinks when scanning for custom tools, hooks, and slash commands. ([#219](https://github.com/badlogic/pi-mono/pull/219), [#232](https://github.com/badlogic/pi-mono/pull/232) by [@aliou](https://github.com/aliou))
|
|
791
829
|
|
|
792
830
|
### Breaking Changes
|
|
793
831
|
|
|
794
|
-
- **Custom tools now require `index.ts` entry point**: Auto-discovered custom tools must be in a subdirectory with an `index.ts` file. The old pattern `~/.
|
|
832
|
+
- **Custom tools now require `index.ts` entry point**: Auto-discovered custom tools must be in a subdirectory with an `index.ts` file. The old pattern `~/.omp/agent/tools/mytool.ts` must become `~/.omp/agent/tools/mytool/index.ts`. This allows multi-file tools to import helper modules. Explicit paths via `--tool` or `settings.json` still work with any `.ts` file.
|
|
795
833
|
|
|
796
834
|
- **Hook `tool_result` event restructured**: The `ToolResultEvent` now exposes full tool result data instead of just text. ([#233](https://github.com/badlogic/pi-mono/pull/233))
|
|
797
835
|
- Removed: `result: string` field
|
|
@@ -859,13 +897,13 @@ Total color count increased from 46 to 50. See [docs/theme.md](docs/theme.md) fo
|
|
|
859
897
|
|
|
860
898
|
- Fixed TUI performance regression caused by Box component lacking render caching. Built-in tools now use Text directly (like v0.22.5), and Box has proper caching for custom tool rendering.
|
|
861
899
|
|
|
862
|
-
- Fixed custom tools failing to load from `~/.
|
|
900
|
+
- Fixed custom tools failing to load from `~/.omp/agent/tools/` when omp is installed globally. Module imports (`@sinclair/typebox`, `@oh-my-pi/pi-tui`, `@oh-my-pi/pi-ai`) are now resolved via aliases.
|
|
863
901
|
|
|
864
902
|
## [0.23.0] - 2025-12-17
|
|
865
903
|
|
|
866
904
|
### Added
|
|
867
905
|
|
|
868
|
-
- **Custom tools**: Extend
|
|
906
|
+
- **Custom tools**: Extend omp with custom tools written in TypeScript. Tools can provide custom TUI rendering, interact with users via `omp.ui` (select, confirm, input, notify), and maintain state across sessions via `onSession` callback. See [docs/custom-tools.md](docs/custom-tools.md) and [examples/custom-tools/](examples/custom-tools/). ([#190](https://github.com/badlogic/pi-mono/issues/190))
|
|
869
907
|
|
|
870
908
|
- **Hook and tool examples**: Added `examples/hooks/` and `examples/custom-tools/` with working examples. Examples are now bundled in npm and binary releases.
|
|
871
909
|
|
|
@@ -955,7 +993,7 @@ _Dedicated to Peter's shoulder ([@steipete](https://twitter.com/steipete))_
|
|
|
955
993
|
|
|
956
994
|
### Breaking Changes
|
|
957
995
|
|
|
958
|
-
- **
|
|
996
|
+
- **OMP skills now use `SKILL.md` convention**: OMP skills must now be named `SKILL.md` inside a directory, matching Codex CLI format. Previously any `*.md` file was treated as a skill. Migrate by renaming `~/.omp/agent/skills/foo.md` to `~/.omp/agent/skills/foo/SKILL.md`.
|
|
959
997
|
|
|
960
998
|
### Added
|
|
961
999
|
|
|
@@ -971,7 +1009,7 @@ _Dedicated to Peter's shoulder ([@steipete](https://twitter.com/steipete))_
|
|
|
971
1009
|
|
|
972
1010
|
### Added
|
|
973
1011
|
|
|
974
|
-
- **Skills system**: Auto-discover and load instruction files on-demand. Supports Claude Code (`~/.claude/skills/*/SKILL.md`), Codex CLI (`~/.codex/skills/`), and
|
|
1012
|
+
- **Skills system**: Auto-discover and load instruction files on-demand. Supports Claude Code (`~/.claude/skills/*/SKILL.md`), Codex CLI (`~/.codex/skills/`), and OMP-native formats (`~/.omp/agent/skills/`, `.omp/skills/`). Skills are listed in system prompt with descriptions, agent loads them via read tool when needed. Supports `{baseDir}` placeholder. Disable with `--no-skills` or `skills.enabled: false` in settings. ([#169](https://github.com/badlogic/pi-mono/issues/169))
|
|
975
1013
|
|
|
976
1014
|
- **Version flag**: Added `--version` / `-v` flag to display the current version and exit. ([#170](https://github.com/badlogic/pi-mono/pull/170))
|
|
977
1015
|
|
|
@@ -989,7 +1027,7 @@ _Dedicated to Peter's shoulder ([@steipete](https://twitter.com/steipete))_
|
|
|
989
1027
|
|
|
990
1028
|
- **In-memory branching for `--no-session` mode**: Branching now works correctly in `--no-session` mode without creating any session files. The conversation is truncated in memory.
|
|
991
1029
|
|
|
992
|
-
- **Git branch indicator now works in subdirectories**: The footer's git branch detection now walks up the directory hierarchy to find the git root, so it works when running
|
|
1030
|
+
- **Git branch indicator now works in subdirectories**: The footer's git branch detection now walks up the directory hierarchy to find the git root, so it works when running omp from a subdirectory of a repository. ([#156](https://github.com/badlogic/pi-mono/issues/156))
|
|
993
1031
|
|
|
994
1032
|
## [0.18.1] - 2025-12-10
|
|
995
1033
|
|
|
@@ -1005,7 +1043,7 @@ _Dedicated to Peter's shoulder ([@steipete](https://twitter.com/steipete))_
|
|
|
1005
1043
|
|
|
1006
1044
|
### Added
|
|
1007
1045
|
|
|
1008
|
-
- **Hooks system**: TypeScript modules that extend agent behavior by subscribing to lifecycle events. Hooks can intercept tool calls, prompt for confirmation, modify results, and inject messages from external sources. Auto-discovered from `~/.
|
|
1046
|
+
- **Hooks system**: TypeScript modules that extend agent behavior by subscribing to lifecycle events. Hooks can intercept tool calls, prompt for confirmation, modify results, and inject messages from external sources. Auto-discovered from `~/.omp/agent/hooks/*.ts` and `.omp/hooks/*.ts`. Thanks to [@nicobailon](https://github.com/nicobailon) for the collaboration on the design and implementation. ([#145](https://github.com/badlogic/pi-mono/issues/145), supersedes [#158](https://github.com/badlogic/pi-mono/pull/158))
|
|
1009
1047
|
|
|
1010
1048
|
- **`pi.send()` API**: Hooks can inject messages into the agent session from external sources (file watchers, webhooks, CI systems). If streaming, messages are queued; otherwise a new agent loop starts immediately.
|
|
1011
1049
|
|
|
@@ -1083,7 +1121,7 @@ _Dedicated to Peter's shoulder ([@steipete](https://twitter.com/steipete))_
|
|
|
1083
1121
|
|
|
1084
1122
|
- **xhigh thinking level**: Added `xhigh` thinking level for OpenAI codex-max models. Cycle through thinking levels with Shift+Tab; `xhigh` appears only when using a codex-max model. ([#143](https://github.com/badlogic/pi-mono/issues/143))
|
|
1085
1123
|
|
|
1086
|
-
- **Collapse changelog setting**: Add `"collapseChangelog": true` to `~/.
|
|
1124
|
+
- **Collapse changelog setting**: Add `"collapseChangelog": true` to `~/.omp/agent/settings.json` to show a condensed "Updated to vX.Y.Z" message instead of the full changelog after updates. Use `/changelog` to view the full changelog. ([#148](https://github.com/badlogic/pi-mono/issues/148))
|
|
1087
1125
|
|
|
1088
1126
|
- **Bash mode**: Execute shell commands directly from the editor by prefixing with `!` (e.g., `!ls -la`). Output streams in real-time, is added to the LLM context, and persists in session history. Supports multiline commands, cancellation (Escape), truncation for large outputs, and preview/expand toggle (Ctrl+O). Also available in RPC mode via `{"type":"bash","command":"..."}`. ([#112](https://github.com/badlogic/pi-mono/pull/112), original implementation by [@markusylisiurunen](https://github.com/markusylisiurunen))
|
|
1089
1127
|
|
|
@@ -1103,7 +1141,7 @@ _Dedicated to Peter's shoulder ([@steipete](https://twitter.com/steipete))_
|
|
|
1103
1141
|
|
|
1104
1142
|
### Added
|
|
1105
1143
|
|
|
1106
|
-
- **Flexible Windows shell configuration**: The bash tool now supports multiple shell sources beyond Git Bash. Resolution order: (1) custom `shellPath` in settings.json, (2) Git Bash in standard locations, (3) any bash.exe on PATH. This enables Cygwin, MSYS2, and other bash environments. Configure with `~/.
|
|
1144
|
+
- **Flexible Windows shell configuration**: The bash tool now supports multiple shell sources beyond Git Bash. Resolution order: (1) custom `shellPath` in settings.json, (2) Git Bash in standard locations, (3) any bash.exe on PATH. This enables Cygwin, MSYS2, and other bash environments. Configure with `~/.omp/agent/settings.json`: `{"shellPath": "C:\\cygwin64\\bin\\bash.exe"}`.
|
|
1107
1145
|
|
|
1108
1146
|
### Fixed
|
|
1109
1147
|
|
|
@@ -1197,7 +1235,7 @@ _Dedicated to Peter's shoulder ([@steipete](https://twitter.com/steipete))_
|
|
|
1197
1235
|
|
|
1198
1236
|
### Added
|
|
1199
1237
|
|
|
1200
|
-
- **Forking/Rebranding Support**: All branding (app name, config directory, environment variable names) is now configurable via `
|
|
1238
|
+
- **Forking/Rebranding Support**: All branding (app name, config directory, environment variable names) is now configurable via `ompConfig` in `package.json`. Forks can change `ompConfig.name` and `ompConfig.configDir` to rebrand the CLI without code changes. Affects CLI banner, help text, config paths, and error messages. ([#95](https://github.com/badlogic/pi-mono/pull/95))
|
|
1201
1239
|
|
|
1202
1240
|
### Fixed
|
|
1203
1241
|
|
|
@@ -1316,7 +1354,7 @@ _Dedicated to Peter's shoulder ([@steipete](https://twitter.com/steipete))_
|
|
|
1316
1354
|
|
|
1317
1355
|
### Added
|
|
1318
1356
|
|
|
1319
|
-
- **File-based Slash Commands**: Create custom reusable prompts as `.txt` files in `~/.
|
|
1357
|
+
- **File-based Slash Commands**: Create custom reusable prompts as `.txt` files in `~/.omp/slash-commands/`. Files become `/filename` commands with first-line descriptions. Supports `{{selection}}` placeholder for referencing selected/attached content.
|
|
1320
1358
|
- **`/branch` Command**: Create conversation branches from any previous user message. Opens a selector to pick a message, then creates a new session file starting from that point. Original message text is placed in the editor for modification.
|
|
1321
1359
|
- **Unified Content References**: Both `@path` in messages and `--file path` CLI arguments now use the same attachment system with consistent MIME type detection.
|
|
1322
1360
|
- **Drag & Drop Files**: Drop files onto the terminal to attach them to your message. Supports multiple files and both text and image content.
|
|
@@ -1378,7 +1416,7 @@ _Dedicated to Peter's shoulder ([@steipete](https://twitter.com/steipete))_
|
|
|
1378
1416
|
|
|
1379
1417
|
### Added
|
|
1380
1418
|
|
|
1381
|
-
- Added thinking level persistence. Default level stored in `~/.
|
|
1419
|
+
- Added thinking level persistence. Default level stored in `~/.omp/settings.json`, restored on startup. Per-session overrides saved in session files.
|
|
1382
1420
|
- Added model cycling shortcut: `Ctrl+I` cycles through available models (or scoped models with `-m` flag).
|
|
1383
1421
|
- Added automatic retry with exponential backoff for transient API errors (network issues, 500s, overload).
|
|
1384
1422
|
- Cumulative token usage now shown in footer (total tokens used across all messages in session).
|
|
@@ -1395,7 +1433,7 @@ _Dedicated to Peter's shoulder ([@steipete](https://twitter.com/steipete))_
|
|
|
1395
1433
|
|
|
1396
1434
|
### Added
|
|
1397
1435
|
|
|
1398
|
-
- Add custom model configuration via `~/.
|
|
1436
|
+
- Add custom model configuration via `~/.omp/models.json`
|
|
1399
1437
|
|
|
1400
1438
|
## [0.10.0] - 2025-11-25
|
|
1401
1439
|
|