tatbot command reference¶
Offline CLI workflows for public development and replay. Maintainers can inspect the complete machine-readable schema with tatbot schema --json.
tatbot [global flags] <noun> [verb] [args] [-- passthrough args]
Global flags may appear anywhere before the first --, as --flag value or --flag=value, unless a declared command option owns that spelling: --json, --dry-run, --explain, -q, -v. Stating one twice with different values is a usage error.
--json execution is supported only by commands declaring structured output in schema --json; all commands support JSON plans and explanations. Backend flags on structured commands require --; tokens after it are preserved.
CLI-owned exit codes are below. Executed backends and SSH retain their own exit codes and error output; backend failures are not remapped to 1.
Exit codes¶
code |
meaning |
|---|---|
0 |
ok |
1 |
underlying tool failed |
2 |
usage error |
3 |
safety gate refused |
4 |
wrong node for this verb |
5 |
hardware unreachable |
6 |
busy |
Safety tiers¶
tier |
meaning |
gates |
|---|---|---|
|
files only |
— |
Verbs¶
tatbot completion — generate opt-in shell completion¶
verb |
tier |
runs on |
wraps |
summary |
|---|---|---|---|---|
|
|
this checkout |
native |
print Bash completion generated from canonical command metadata |
tatbot body — immutable human body model assets and cache audit¶
verb |
tier |
runs on |
wraps |
summary |
|---|---|---|---|---|
|
|
this checkout |
native |
copy a pinned, pre-downloaded MHR and SOMA allowlist into an explicit verified cache |
|
|
this checkout |
native |
read and hash every byte in an explicit MHR and SOMA cache without deserializing it |
tatbot teleop — leader→follower teleoperation¶
verb |
tier |
runs on |
wraps |
summary |
|---|---|---|---|---|
|
|
this checkout |
|
export measured follower tip poses and host read timestamps from a flight log ( |
|
|
this checkout |
|
loop-timing stats from a .wxtl without a GUI |
tatbot rollout — offline checks of a trained policy: its contract, its action plausibility¶
verb |
tier |
runs on |
wraps |
summary |
|---|---|---|---|---|
|
|
this checkout |
|
no-robot plausibility check of a policy’s action chunks ( |
|
|
this checkout |
|
the input/action contract stored with a checkpoint ( |
tatbot calib — native arm measurements and retained overhead registration¶
verb |
tier |
runs on |
wraps |
summary |
|---|---|---|---|---|
|
|
this checkout |
|
fit an unadopted overhead registration from original native holds and shared geometry |
tatbot vision — offline vision processing and calibration¶
verb |
tier |
runs on |
wraps |
summary |
|---|---|---|---|---|
|
|
this checkout |
|
compare filters on a retained raw scan burst |
|
|
this checkout |
|
generate the skin stencil: a fiducial tile of AprilTag 16h5 markers with its 300 dpi print |
|
|
this checkout |
|
export a tracking manifest for a generated fiducial tile, and install it where the observer reads |
|
|
this checkout |
|
render the wrist-tag print sheet ( |
|
|
this checkout |
|
plane-route hand-eye for the wrist D405s: fit depth planes against the touched-off paper ( |
tatbot drawingbot — DrawingBotV3 stroke experiments and preference review¶
verb |
tier |
runs on |
wraps |
summary |
|---|---|---|---|---|
|
|
this checkout |
|
generate one physical DBV3 drawing with verified settings and a saved native recipe |
|
|
this checkout |
|
verify and replay native SVG acquisition only, without ROS compilation |
|
|
this checkout |
|
build, smoke-test or run the private mounted-app acquisition container |
tatbot inkmap — ground InkLang placements and preview tattoos on canonical bodies¶
verb |
tier |
runs on |
wraps |
summary |
|---|---|---|---|---|
|
|
this checkout |
|
the tattoo preview app on this machine ( |
|
|
this checkout |
|
resolve InkLang placement text to a canonical rest-surface anchor as JSON |
tatbot profile — inspect and validate hardware profiles¶
verb |
tier |
runs on |
wraps |
summary |
|---|---|---|---|---|
|
|
this checkout |
|
the resolved hardware profile: backend, arms, e-stop, provenance |
|
|
this checkout |
|
the profiles this checkout carries |
|
|
this checkout |
|
can the resolved profile drive hardware? (exit 3 if not) |
tatbot art — palette-aware design: ink gamut, predicted appearance and minutes¶
verb |
tier |
runs on |
wraps |
summary |
|---|---|---|---|---|
|
|
this checkout |
|
the achievable-palette sheet: every tint and two-ink hatch mix a palette load can draw |
|
|
this checkout |
|
predicted appearance of a program as ink on a substrate, with dips, rinses and minutes |
|
|
this checkout |
|
drawing, descent, lift, travel, dipping and rinse time from a saved compiled program |
|
|
this checkout |
|
a flat-colour image into per-ink DBV3 layers, a compiled program and a predicted render |
|
|
this checkout |
|
a round composed for a stencil tile, each design separated at its size and compiled onto the print |
|
|
this checkout |
|
Inkmap’s robot renders of its stock designs, each through DBV3 at its width |
|
|
this checkout |
|
measure the hatch fill’s grey-to-coverage response with a DBV3 step wedge |
|
|
this checkout |
|
a tone image as whip strokes or pendulum zigzags whose deposition fades with the tone, rendered |
|
|
this checkout |
|
a round’s designs as voting-wall documents: genes, views, minutes and fidelity |
|
|
this checkout |
|
the next round’s Flow prompts from the wall’s votes: the best genes, plus some untried ones |
|
|
this checkout |
|
the voting wall’s map: designs placed by genes and look, clustered, linked to their nearest |
|
|
this checkout |
|
the design pyramid’s next pass: draw kept sketches, study kept drawings in every fill |
|
|
this checkout |
|
drawn designs as reviewable bundles: the acquired layers, their ink loads, program and render |
tatbot lab — studies of what the rig can tattoo: trials, cells, plans and camera readings¶
verb |
tier |
runs on |
wraps |
summary |
|---|---|---|---|---|
|
|
this checkout |
|
a study: its question, print, cartridges, inks, caps and the bounds of each setting |
|
|
this checkout |
|
trials from a JSON-lines file, a cartridge’s characterization card, or the search |
|
|
this checkout |
|
each archive’s bins of darkness and its second descriptor, and the elite trial of each |
|
|
this checkout |
|
proposed trials into runs on a sheet: programs, the draw commands and cell manifests |
|
|
this checkout |
|
each study’s trials by status, its plans and the cells used on each sheet |
|
|
this checkout |
|
a run’s cells photographed by the overhead and every wrist camera from a hold over each (tatbot ros views) |
|
|
this checkout |
|
one planned run on the rig: its cells photographed before, drawn, photographed after, and read |
|
|
this checkout |
|
a drawn run’s cells from before and after frames: darkening, carry, fade, bands, speckle |
Bash completion¶
Generate and source completion explicitly (Bash 4+):
tatbot completion bash > /tmp/tatbot-completion.bash
source /tmp/tatbot-completion.bash
Generation prints shell code; it does not install anything or edit shell startup files. Completion is generated from the canonical commands, options and choices.
Examples¶
tatbot completion bash
tatbot body bootstrap --spec config/body-models/mhr-soma-v1.json --cache-dir '<path>' --source-dir '<path>'
tatbot body audit --spec config/body-models/mhr-soma-v1.json --cache-dir '<path>'
tatbot teleop poses flight.wxtl --out '<path>' --urdf urdf/tatbot.urdf --workspace config/workspace.yaml
tatbot teleop analyze '<path>'
tatbot rollout bench plausibility -- --help
tatbot rollout contract '<path>'
tatbot calib register-fit --python '<path>' --arm pink --capture '<path>' --bundle '<path>' --setup-id table-setup --out '<path>'
tatbot vision depth compare --capture capture-1.npz --settings filters.json
tatbot vision stencil generate --preset silicone --seed 0 --output '<path>'
tatbot vision stencil reference --settings stencil/settings.json
tatbot vision tags print -- --help
tatbot vision handeye d405 --self-test
tatbot drawingbot generate '<path>' --out '<path>' --app '<path>'
tatbot drawingbot export '<path>' --out '<path>' --app '<path>'
tatbot drawingbot container build --out '<path>'
tatbot inkmap dev
tatbot inkmap resolve --prompt 'left upper inner forearm'
tatbot profile show
tatbot profile list
tatbot profile check
tatbot art swatch --inks golden_yellow,bright_red,light_green,light_purple,true_black --out '<path>'
tatbot art render '<path>' --substrate skin-3 --out '<path>'
tatbot art profile '<path>' --out '<path>'
tatbot art separate flash.png --inks golden_yellow,bright_red,light_green,blue_sky,true_black --width-mm 60 --out '<path>' --app '<path>'
tatbot art tiles --plan '<path>' --corpus '<path>' --stencil '<path>' --out '<path>' --app '<path>'
tatbot art stock-renders --app '<path>' --out '<path>'
tatbot art tone --app '<path>' --out '<path>'
tatbot art shade '<path>' --width-mm 30 --technique pendulum --tool '<tool-id>' --out '<path>'
tatbot art wall --round 1 --plan '<path>' --corpus '<path>' --assets '<path>' --out '<path>'
tatbot art propose --designs '<path>' --votes '<path>' --round 2 --out '<path>'
tatbot art map --designs '<path>' --corpus '<path>' --out '<path>'
tatbot art promote --designs '<path>' --votes '<path>' --corpus '<path>' --out '<path>'
tatbot art bundle --votes '<path>' --corpus '<path>' --out '<path>'
tatbot lab new --id card-3rl --question 'What does the 3RL lay at each depth?' --stencil '<path>' --cartridges '<tool-id>' --inks true_black,bright_red --palette true_black=inkcap_large_2,bright_red=inkcap_medium_1,water=inkcap_large_1 --bound trim_mm=-2.5:-1.0 --bound speed_mm_s=2.5:6
tatbot lab propose card-3rl --card '<tool-id>'
tatbot lab map card-3rl
tatbot lab plan card-3rl --stencil '<path>' --sheet bef888-a
tatbot lab status card-3rl
tatbot lab capture card-3rl --plan p0001 --run run-01 --side before
tatbot lab run card-3rl --plan p0001 --run run-01 --stencil '<path>' --sheet-at=400,-100
tatbot lab read card-3rl --plan p0001 --run run-01 --stencil '<path>'