@kolisachint/hoocode-agent 0.5.25 → 0.5.27

package/docs/session-format.md

@@ -5,14 +5,14 @@ Sessions are stored as JSONL (JSON Lines) files. Each line is a JSON object with
 ## File Location
 
 ```
-~/.hoocode/agent/sessions/--<path>--/<timestamp>_<uuid>.jsonl
+~/.hoocode/sessions/--<path>--/<timestamp>_<uuid>.jsonl
 ```
 
 Where `<path>` is the working directory with `/` replaced by `-`.
 
 ## Deleting Sessions
 
-Sessions can be removed by deleting their `.jsonl` files under `~/.hoocode/agent/sessions/`.
+Sessions can be removed by deleting their `.jsonl` files under `~/.hoocode/sessions/`.
 
 HooCode also supports deleting sessions interactively from `/resume` (select a session and press `Ctrl+D`, then confirm). When available, hoocode uses the `trash` CLI to avoid permanent deletion.
 
@@ -28,7 +28,7 @@ Existing sessions are automatically migrated to the current version (v3) when lo
 
 ## Source Files
 
-Source on GitHub ([pi-mono](https://github.com/kolisachint/hoocode)):
+Source on GitHub ([hoocode](https://github.com/kolisachint/hoocode)):
 - [`packages/coding-agent/src/core/session-manager.ts`](https://github.com/kolisachint/hoocode/blob/main/packages/coding-agent/src/core/session-manager.ts) - Session entry types and SessionManager
 - [`packages/coding-agent/src/core/messages.ts`](https://github.com/kolisachint/hoocode/blob/main/packages/coding-agent/src/core/messages.ts) - Extended message types (BashExecutionMessage, CustomMessage, etc.)
 - [`packages/ai/src/types.ts`](https://github.com/kolisachint/hoocode/blob/main/packages/ai/src/types.ts) - Base message types (UserMessage, AssistantMessage, ToolResultMessage)

package/docs/sessions.md

@@ -4,7 +4,7 @@ HooCode saves conversations as sessions so you can continue work, branch from ea
 
 ## Session Storage
 
-Sessions auto-save to `~/.hoocode/agent/sessions/`, organized by working directory. Each session is a JSONL file with a tree structure.
+Sessions auto-save to `~/.hoocode/sessions/`, organized by working directory. Each session is a JSONL file with a tree structure.
 
 ```bash
 hoocode -c                  # Continue most recent session

package/docs/settings.md

@@ -4,7 +4,7 @@ HooCode uses JSON settings files with project settings overriding global setting
 
 | Location | Scope |
 |----------|-------|
-| `~/.hoocode/agent/settings.json` | Global (all projects) |
+| `~/.hoocode/settings.json` | Global (all projects) |
 | `.hoocode/settings.json` | Project (current directory) |
 
 Edit directly or use `/settings` for common options.
@@ -244,7 +244,7 @@ window.
 
 These settings define where to load extensions, skills, prompts, and themes from.
 
-Paths in `~/.hoocode/agent/settings.json` resolve relative to `~/.hoocode/agent`. Paths in `.hoocode/settings.json` resolve relative to `.hoocode`. Absolute paths and `~` are supported.
+Paths in `~/.hoocode/settings.json` resolve relative to `~/.hoocode`. Paths in `.hoocode/settings.json` resolve relative to `.hoocode`. Absolute paths and `~` are supported.
 
 | Setting | Type | Default | Description |
 |---------|------|---------|-------------|
@@ -313,7 +313,7 @@ See [packages.md](packages.md) for package management details.
 Project settings (`.hoocode/settings.json`) override global settings. Nested objects are merged:
 
 ```json
-// ~/.hoocode/agent/settings.json (global)
+// ~/.hoocode/settings.json (global)
 {
   "theme": "dark",
   "compaction": { "enabled": true, "reserveTokens": 16384 }

package/docs/shell-aliases.md

@@ -2,7 +2,7 @@
 
 HooCode runs bash in non-interactive mode (`bash -c`), which doesn't expand aliases by default.
 
-To enable your shell aliases, add to `~/.hoocode/agent/settings.json`:
+To enable your shell aliases, add to `~/.hoocode/settings.json`:
 
 ```json
 {

package/docs/skills.md

@@ -24,7 +24,7 @@ HooCode implements the [Agent Skills standard](https://agentskills.io/specificat
 HooCode loads skills from:
 
 - Global:
-  - `~/.hoocode/agent/skills/`
+  - `~/.hoocode/skills/`
   - `~/.agents/skills/`
 - Project:
   - `.hoocode/skills/`
@@ -34,7 +34,7 @@ HooCode loads skills from:
 - CLI: `--skill <path>` (repeatable, additive even with `--no-skills`)
 
 Discovery rules:
-- In `~/.hoocode/agent/skills/` and `.hoocode/skills/`, direct root `.md` files are discovered as individual skills
+- In `~/.hoocode/skills/` and `.hoocode/skills/`, direct root `.md` files are discovered as individual skills
 - In all skill locations, directories containing `SKILL.md` are discovered recursively
 - In `~/.agents/skills/` and project `.agents/skills/`, root `.md` files are ignored
 

package/docs/terminal-setup.md

@@ -24,7 +24,7 @@ That mapping sends a raw linefeed byte. Inside hoocode, that is indistinguishabl
 
 If Claude Code 2.x or newer is the only reason you added that mapping, you can remove it, unless you want to use Claude Code in tmux, where it still requires that Ghostty mapping.
 
-If you want `Shift+Enter` to keep working in tmux via that remap, add `ctrl+j` to your hoocode `newLine` keybinding in `~/.hoocode/agent/keybindings.json`:
+If you want `Shift+Enter` to keep working in tmux via that remap, add `ctrl+j` to your hoocode `newLine` keybinding in `~/.hoocode/keybindings.json`:
 
 ```json
 {

package/docs/termux.md

@@ -20,7 +20,7 @@ pkg install nodejs termux-api git
 npm install -g @kolisachint/hoocode-agent
 
 # Create config directory
-mkdir -p ~/.hoocode/agent
+mkdir -p ~/.hoocode
 
 # Run hoocode
 hoocode
@@ -34,7 +34,7 @@ Image clipboard is not supported on Termux (the `ctrl+v` image paste feature wil
 
 ## Example AGENTS.md for Termux
 
-Create `~/.hoocode/agent/AGENTS.md` to help the agent understand the Termux environment:
+Create `~/.hoocode/AGENTS.md` to help the agent understand the Termux environment:
 
 ```markdown
 # Agent Environment: Termux on Android

package/docs/themes.md

@@ -20,7 +20,7 @@ Themes are JSON files that define colors for the TUI.
 HooCode loads themes from:
 
 - Built-in: every `*.json` in the shipped theme directory (see [Built-in Themes](#built-in-themes))
-- Global: `~/.hoocode/agent/themes/*.json`
+- Global: `~/.hoocode/themes/*.json`
 - Project: `.hoocode/themes/*.json`
 - Packages: `themes/` directories or `pi.themes` entries in `package.json`
 - Settings: `themes` array with files or directories
@@ -113,8 +113,8 @@ On first run, hoocode detects your terminal background and defaults to `dark` or
 1. Create a theme file:
 
 ```bash
-mkdir -p ~/.hoocode/agent/themes
-vim ~/.hoocode/agent/themes/my-theme.json
+mkdir -p ~/.hoocode/themes
+vim ~/.hoocode/themes/my-theme.json
 ```
 
 2. Define the theme with all required colors (see [Color Tokens](#color-tokens)):

package/docs/usage.md

@@ -54,8 +54,56 @@ Type `/` in the editor to open command completion. Extensions can register custo
 | `/reload` | Reload keybindings, extensions, skills, prompts, and context files |
 | `/hotkeys` | Show all keyboard shortcuts |
 | `/changelog` | Display version history |
+| `/import <file>` | Import and resume a session from a JSONL file |
+| `/cost` | Session token and cost totals, broken down by model |
 | `/quit` | Quit hoocode |
 
+### Modes and planning
+
+See [Modes](modes.md) for what each mode changes.
+
+| Command | Description |
+|---------|-------------|
+| `/mode <ask\|plan\|build\|debug>` | Switch the active mode |
+| `/plan` | Shorthand for `/mode plan` |
+| `/approve` | Approve the current plan and switch to build mode to execute it |
+| `/grill [me\|plan]` | Stress-test the current plan before committing to it |
+| `/goal [--max-turns N] <objective>` | Work autonomously toward a goal |
+
+### Plugins and extensibility
+
+See [Plugins](plugins.md) for the marketplace and trust model.
+
+| Command | Description |
+|---------|-------------|
+| `/plugin marketplace add <git-url\|path>` | Register a marketplace |
+| `/plugin marketplace list\|refresh` | List registered marketplaces, or re-fetch their indices |
+| `/plugin list` | List installed plugins |
+| `/plugin install <name> [--scope user\|project]` | Install a plugin |
+| `/plugin remove <name>` | Uninstall a plugin |
+| `/plugin trust [list]`, `/plugin untrust` | Inspect or revoke workspace trust |
+| `/plugin publish <name> [--to <dir>]` | Package a plugin for distribution |
+| `/new-skill <name>` | Scaffold a new skill |
+| `/new-agent <name>` | Scaffold a new subagent |
+| `/new-command <name>` | Scaffold a new slash command |
+| `/new-canvas <what it should do>` | Scaffold a canvas extension and build it; `/new-canvas <name>` scaffolds the template only |
+
+### Canvas and scheduling
+
+| Command | Description |
+|---------|-------------|
+| `/canvas list` | List canvases the loaded extensions provide |
+| `/canvas open <extension>[:<canvas>]` | Open a canvas |
+| `/canvas reload [extension]` | Pick up code changes without restarting the session |
+| `/canvas close <instanceId>` | Close a running canvas |
+| `/canvas rename <extension> <new-name>` | Rename a canvas everywhere its name appears |
+| `/canvas remove <extension>` | Delete a canvas, after confirming |
+| `/loop "<cron>" <prompt>` | Schedule a prompt on a cron expression |
+| `/loop <5m\|2h> <prompt>` | Schedule a prompt on an interval |
+| `/loop once "<cron>" <prompt>` | Schedule a one-shot prompt |
+| `/loop list`, `/loop delete <id>`, `/loop stop` | Inspect and cancel schedules |
+| `/loop auto [--max-turns N] <task>` | Run an autonomous loop on a task |
+
 ## Message Queue
 
 You can submit messages while the agent is still working:
@@ -71,7 +119,7 @@ Configure delivery in [Settings](settings.md) with `steeringMode` and `followUpM
 
 ## Sessions
 
-Sessions are saved automatically to `~/.hoocode/agent/sessions/`, organized by working directory.
+Sessions are saved automatically to `~/.hoocode/sessions/`, organized by working directory.
 
 ```bash
 hoocode -c                  # Continue most recent session
@@ -96,7 +144,7 @@ See [Sessions](sessions.md) and [Compaction](compaction.md) for details.
 HooCode loads `AGENTS.md` or `CLAUDE.md` at startup from, least specific first:
 
 - `~/.agents/AGENTS.md` — the cross-vendor user scope, shared with other agent tools
-- `~/.hoocode/agent/AGENTS.md` — hoocode's own global instructions, which win on conflict
+- `~/.hoocode/AGENTS.md` — hoocode's own global instructions, which win on conflict
 - parent directories, walking up from the current working directory
 - the current directory
 
@@ -182,7 +230,7 @@ the same path the sessions were recorded under.
 Replace the default system prompt with:
 
 - `.hoocode/SYSTEM.md` for a project
-- `~/.hoocode/agent/SYSTEM.md` globally
+- `~/.hoocode/SYSTEM.md` globally
 
 Append to the default prompt without replacing it with `APPEND_SYSTEM.md` in either location.
 
@@ -259,11 +307,34 @@ cat README.md | hoocode -p "Summarize this text"
 | Option | Description |
 |--------|-------------|
 | `--tools <list>`, `-t <list>` | Allowlist specific built-in, extension, and custom tools |
+| `--disallowed-tools <list>` | Comma-separated denylist, subtracted from the allowlist or default set |
 | `--no-builtin-tools`, `-nbt` | Disable built-in tools but keep extension/custom tools enabled |
 | `--no-tools`, `-nt` | Disable all tools |
 
 Built-in tools: `read`, `bash`, `edit`, `write`, `grep`, `find`, `ls`.
 
+#### Optional tool bundles
+
+Off by default unless noted; each adds a capability rather than a single tool.
+
+| Option | Enables |
+|--------|---------|
+| `--enable-todowrite` | The TodoWrite tool — a live todo list in the task panel |
+| `--enable-webtools` | `webfetch` and `websearch` (network access) |
+| `--enable-search-tool` | The semantic index behind the `search` tool (on by default). Legacy alias: `--enable-embsearchtools` |
+| `--enable-plugintools` | The autonomous plugin system — see [Plugins](plugins.md) |
+
+#### Subagents
+
+See [Subagent delegation](routing.md).
+
+| Option | Description |
+|--------|-------------|
+| `--enable-subagents` | Enable the subagent tool (delegate to isolated agent loops) |
+| `--no-subagents`, `--disable-subagents` | Disable it for this session, overriding the setting |
+| `--max-subagent-depth <n>` | Tree-wide nesting cap (default 2 — one level of nesting) |
+| `--warm-subagents` | Dispatch eligible subagents on reused warm RPC workers (experimental) |
+
 ### Resource Options
 
 | Option | Description |
@@ -290,10 +361,28 @@ hoocode --no-extensions -e ./my-extension.ts
 |--------|-------------|
 | `--system-prompt <text>` | Replace default prompt; context files and skills are still appended |
 | `--append-system-prompt <text>` | Append to system prompt |
+| `--light` | Minimal low-token preset for small/local models (see below) |
+| `--print-token-surface` | Print the fixed per-turn surface (system prompt + serialized tool schemas) and exit |
+| `--platform <list>` | Platform layout(s) to target when writing artifacts: `claude`, `copilot` (alias `github`, `gh`), `agents` (alias `native`). Comma-separated and/or repeated |
+| `--team <url\|auto>` | Bridge a hooteams server into the task panel's teams view — focus roles, nudge, attach, answer approval gates. `auto` searches upward from cwd for `.agents/teams/default.json` or `hooteams.config.json` and spawns hooteams locally |
 | `--verbose` | Force verbose startup |
 | `-h`, `--help` | Show help |
 | `-v`, `--version` | Show version |
 
+#### Light mode
+
+`--light` (or the `light` setting) trims the session to the smallest useful
+fixed per-turn surface, for small or local models that waste context on harness
+boilerplate:
+
+- Only `read`, `write`, `edit`, and `bash`, with short descriptions and stripped
+  parameter schemas. `bash` subsumes grep/find/ls — search happens via the shell.
+- A terse replacement system prompt.
+- No subagents, TodoWrite, skills, context files, mode appendix, or the
+  self-documentation section.
+
+`--print-token-surface` reports what that surface actually costs.
+
 ### File Arguments
 
 Prefix files with `@` to include them in the message:
@@ -336,7 +425,7 @@ hoocode --tools read,grep,find,ls -p "Review the code"
 
 | Variable | Description |
 |----------|-------------|
-| `HOOCODE_AGENT_DIR` | Override config directory; default is `~/.hoocode/agent` |
+| `HOOCODE_AGENT_DIR` | Override config directory; default is `~/.hoocode` |
 | `HOOCODE_AGENT_SESSION_DIR` | Override session storage directory; overridden by `--session-dir` |
 | `HOOCODE_PACKAGE_DIR` | Override package directory, useful for Nix/Guix store paths |
 | `HOOCODE_OFFLINE` | Disable startup network operations, including update checks, package update checks, and install/update telemetry |

package/docs/windows.md

@@ -2,7 +2,7 @@
 
 HooCode requires a bash shell on Windows. Checked locations (in order):
 
-1. Custom path from `~/.hoocode/agent/settings.json`
+1. Custom path from `~/.hoocode/settings.json`
 2. Git Bash (`C:\Program Files\Git\bin\bash.exe`)
 3. `bash.exe` on PATH (Cygwin, MSYS2, WSL)
 

package/examples/extensions/custom-provider-anthropic/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@kolisachint/hoocode-extension-custom-provider-anthropic",
 	"private": true,
-	"version": "0.3.25",
+	"version": "0.3.27",
 	"type": "module",
 	"engines": {
 		"bun": ">=1.0.0"

package/examples/extensions/custom-provider-gitlab-duo/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@kolisachint/hoocode-extension-custom-provider-gitlab-duo",
 	"private": true,
-	"version": "0.3.25",
+	"version": "0.3.27",
 	"type": "module",
 	"engines": {
 		"bun": ">=1.0.0"

package/examples/extensions/sandbox/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@kolisachint/hoocode-extension-sandbox",
 	"private": true,
-	"version": "0.3.25",
+	"version": "0.3.27",
 	"type": "module",
 	"engines": {
 		"bun": ">=1.0.0"

package/examples/extensions/with-deps/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@kolisachint/hoocode-extension-with-deps",
 	"private": true,
-	"version": "0.3.25",
+	"version": "0.3.27",
 	"type": "module",
 	"engines": {
 		"bun": ">=1.0.0"

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@kolisachint/hoocode-agent",
-	"version": "0.5.25",
+	"version": "0.5.27",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"type": "module",
 	"hoocodeConfig": {
@@ -49,9 +49,9 @@
 		"prepublishOnly": "npm run clean && npm run build"
 	},
 	"dependencies": {
-		"@kolisachint/hoocode-agent-core": "^0.5.25",
-		"@kolisachint/hoocode-ai": "^0.5.25",
-		"@kolisachint/hoocode-tui": "^0.5.25",
+		"@kolisachint/hoocode-agent-core": "^0.5.27",
+		"@kolisachint/hoocode-ai": "^0.5.27",
+		"@kolisachint/hoocode-tui": "^0.5.27",
 		"@silvia-odwyer/photon-node": "^0.3.4",
 		"chalk": "^5.5.0",
 		"cli-highlight": "^2.1.11",