8000 Move the README and guides off the removed session verbs · Issue #3706 · gominimal/minimal · GitHub
[go: up one dir, main page]

Skip to content

Move the README and guides off the removed session verbs #3706

Open

Description

@agent-137

Residual of T66 (#3685, PR #3705), epic #2879. T66 also needs six caller files to drop --sync, which takes it to 33 layer files, over the 30 cap. So the README and guide moves come here. Depends on #3685, because the README line 169 example uses --sync none, which T66 removes.

Edits (from the arch ruling):

  1. README.md:
    • lines 95 and 131: min session activate --attach becomes min session start.
    • line 105: min session activate --name api becomes min session start --detach --name api.
    • line 169: the example uses --sync none, which min session start does not take. Rewrite it with flags min session start takes, or remove it.
    • line 227: becomes min session start --loadout dev.
    • line 86: min session policy becomes min box show <box> --network.
  2. docs/guide/setup.md (lines 2, 62), docs/guide/agents.md (line 21), docs/guide/dev-shell.md (lines 14, 17) and docs/guide/migrate-to-minimal-session.md (lines 61, 63): use min session start, and min session start --detach for the form that only creates.
  3. docs/guide/dev-shell.md line 102: min session destroy <session> becomes min box rm --force <box>.
  4. docs/guide/tasks.md line 9: remove the min session run <session> <name> clause. That verb has no successor (BCLI: a box verb runs a project task inside a running box (session run residual) #3216).

Then grep README.md and docs/ for session activate, session destroy, session run, session exec, session rename, session policy, session hooks and bare min stop, and move any other hit the same way. A line that only records history stays, marked as the removed spelling.

Until this lands, these docs name commands that exit 2 on main once #3678 merges.

Also check README.md and docs/guide/ for --sync, and remove each use. No command takes it after #3685.


This is a residual of epic #2879 (BCLI).

Activity

  1. added
    priority:must-haveMust be done. Applied by the inbox-route classifier or a human.
    kind:taskA task the plan skill rendered; the body carries ## Task
    on Nov 20, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    kind:taskA task the plan skill rendered; the body carries ## Taskpriority:must-haveMust be done. Applied by the inbox-route classifier or a human.

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions

      0