hiiro 0.1.365 → 0.1.367

data/docs/h-bin.md

@@ -1,8 +1,8 @@
 # h-bin
 
-List and edit hiiro bin scripts (`h-*` executables found in PATH).
+Create, list, and edit Hiiro bin scripts.
 
-`h bin` uses `Hiiro::Bins` to scan the current `PATH` for executable files.
+`h bin add` creates executables in `~/bin`. The `list` and `edit` commands use `Hiiro::Bins` to scan the current `PATH`.
 
 ## Synopsis
 
@@ -14,9 +14,56 @@ h bin <subcommand> [names...]
 
 | Subcommand | Description |
 |------------|-------------|
+| `add NAME [COMMAND ...]` | Create an executable template without overwriting an existing file |
 | `list [names]` | List matching bin files |
 | `edit [names]` | Open matching bin files in editor |
 
+### add
+
+Create `~/bin/h-NAME`. An optional `h-` prefix is accepted. Executable names must
+start with a letter or digit and contain only letters, digits, underscores, or
+hyphens.
+
+```sh
+h bin add scratch
+```
+
+With no command arguments, the generated file contains:
+
+```ruby
+#!/usr/bin/env ruby
+
+require 'hiiro'
+
+Hiiro.run do
+end
+```
+
+To include empty command blocks:
+
+```sh
+h bin add josh list show
+```
+
+```ruby
+#!/usr/bin/env ruby
+
+require 'hiiro'
+
+Hiiro.run do
+  add_cmd :list do
+  end
+
+  add_cmd :show do
+  end
+end
+```
+
+Command names are serialized as Ruby symbols, including quoted symbols for
+names such as `hello-world`. Generated files are executable. Existing files
+and symlinks are refused, and no editor or generated command is launched.
+Native Hiiro options handle `--help` and the `--` end-of-options marker.
+
 ### edit
 
 Open matching `h-*` bin files in your editor. With no arguments, opens `h-bin` itself.

data/docs/h-subtask.md

@@ -1,50 +1,11 @@
 # h subtask
 
-Manage subtasks within the current parent task. Subtasks follow the same worktree + Herdr workspace model as top-level tasks, but are scoped under the current task (for example, `my-feature/auth`).
-
-All subcommands are identical to [h task](h-task.md) but operate on the subtask scope. Subtask names are relative (e.g. `auth` rather than `my-feature/auth`).
-
-## Synopsis
+`h subtask` was removed when `h task` became a symlink to `t`. A subtask is a task whose name is `parent/child`:
 
 ```bash
-h subtask <subcommand> [args]
+t my-feature/auth tree new    # worktree at ~/work/my-feature/auth, workspace "my-feature/auth"
+t my-feature/auth todo add Wire the login form
+t my-feature/auth tree rm
 ```
 
-## Scope behavior
-
-When in a task workspace, `h subtask` lists and operates on subtasks of the current parent task. A synthetic `main` subtask is always shown, representing the parent task's primary worktree.
-
-Subtask names are stored as `parent/child` (e.g. `my-feature/auth`) but displayed as their short name (`auth`) in subtask context.
-
-## Subcommands
-
-All subcommands from [h task](h-task.md) are available. Key ones:
-
-| Subcommand | Description |
-|------------|-------------|
-| `ls` / `list` | List subtasks of the current task |
-| `start <name>` | Create or switch to a subtask |
-| `switch [name]` | Switch to a subtask workspace |
-| `stop [name]` | Stop a subtask (preserves worktree) |
-| `current` | Print the current subtask name |
-| `status` / `st` | Show current subtask details |
-| `branch [name]` | Print branch for a subtask |
-| `tree [name]` | Print worktree name for a subtask |
-| `session [name]` | Print session name for a subtask |
-| `cd [name] [app]` | Send `cd` to current pane |
-| `path [name] [app]` | Print path to subtask directory |
-| `todo [args]` | Manage todos for current subtask |
-| `queue [args]` | Claude queue scoped to current subtask |
-
-## Examples
-
-```bash
-h subtask ls
-h subtask start auth
-h subtask switch
-h subtask switch auth
-h subtask current
-h subtask status
-h subtask cd auth
-h subtask stop auth
-```
+See [t](t.md) and [h task](h-task.md).