Command reference

Setup

Command	Description
slice setup	Transform a git repo into a managed thinslice workspace

Worktrees

Command	Description
slice local <name> [-b ref] [--from state] [hook] [args...]	Create a worktree for your own work at local/<name>
slice tmp <name> [-b ref] [--from state] [hook] [args...]	Create a throwaway worktree at tmp/<name>
slice pr checkout <number> [--from state] [hook] [args...]	Fetch a PR and create a worktree at pr/<number>
slice rm <worktree>	Stop processes, remove worktree, delete branch, clean up throwaway state
slice gc	Remove all tmp/ worktrees that aren't running

The worktree path is also the git branch name. slice local feature-auth creates both the directory local/feature-auth and the branch local/feature-auth.

See Worktrees for details.

State

Command	Description
slice state new <name> [--from existing]	Create a new state directory
slice state ls	List state directories with bindings and status
slice state rm <name>	Remove a state directory (refuses if bound or running)

See State for details.

Lifecycle

Command	Description
slice use <state>	Bind the current worktree to a state directory
slice up [profile]	Start processes (optional tmux profile)
slice down	Stop processes, keep binding
slice detach	Stop processes and unbind worktree from state
slice restart [profile]	Stop and restart processes
slice status	Show all worktrees, states, bindings, ports, and status

Config and inspection

Command	Description
slice edit	Open the slice config in $EDITOR (stored in state directory)
slice config	Print resolved configuration to stdout
slice ports	Show port allocations for the current slice
slice logs [process]	Tail process logs

Utility

Command	Description
slice give-me-a-port	Allocate and return a free port (for use inside thinslice.new-state). See Port Registry
slice debug port <number>	Look up what owns a specific port
slice doctor	Full reconciliation of the port registry