CLI
Start and stop Hide
Section titled “Start and stop Hide”hide status
Section titled “hide status”Shows whether Hide is running, with its process, its port and how many clients are connected to it.
hide status [--json]Example:
hide statusSyntax from hide --help; not in the command contract.
hide stop
Section titled “hide stop”Stops Hide’s background service on this machine, so Hide is no longer running until you open it again.
hide stopExample:
hide stopSyntax from hide --help; not in the command contract.
hide version
Section titled “hide version”Shows the version and commit of this Hide build.
hide version [--json]Example:
hide version --jsonSyntax from hide --help; not in the command contract.
For agents and tools
Section titled “For agents and tools”hide guide
Section titled “hide guide”Prints the guide Hide gives an agent in its pane: letters, agents, the operator’s screen and Project Memory.
hide guideExample:
hide guideSyntax from hide --help; not in the command contract.
hide issue help
Section titled “hide issue help”Prints the steps for reporting a bug in Hide itself to its GitHub issues, which an agent follows once you agree.
hide issue helpExample:
hide issue helpSyntax from hide --help; not in the command contract.
hide contract
Section titled “hide contract”Prints the commands that tools call and the answers they get, as JSON, so a tool can check it matches this build.
hide contract --jsonExample:
hide contract --jsonSyntax from hide --help; not in the command contract.
Letters and watches
Section titled “Letters and watches”hide request send
Section titled “hide request send”Sends a letter from an agent’s pane to another agent and keeps its reply; sending again with the same —intent retries that letter without delivering it twice, and a new letter needs a new —intent.
hide request send <target> --intent <key> --body <text> [--kind request|block|report|progress] [--now | --force]Example:
hide request send parent-name --kind progress --intent task-plan-1 --body 'Plan: core first, then web.'| Option | Needed | Value |
|---|---|---|
--intent |
yes | key |
--body |
yes | body |
--kind |
no | one_of |
--now |
no | flag |
--force |
no | flag |
Can be refused as: composer_not_empty, composer_unconfirmed, force_target_asleep, intent_conflict, no_parent, outbox_full, outbox_unavailable, participant_registering.
Syntax from the command contract.
hide request reply
Section titled “hide request reply”Answers a letter you received, so the sender gets your answer with the letter it was about.
hide request reply <id> --intent <key> --body <text>Example:
hide request reply letter-1 --intent task-answer-1 --body 'The check passed.'| Option | Needed | Value |
|---|---|---|
--intent |
yes | key |
--body |
yes | body |
Syntax from the command contract.
hide request ack
Section titled “hide request ack”Records, from the recipient’s own pane, that it received a letter, which is the receipt the sender waits for.
hide request ack|cancel|show <id>Example:
hide request ack letter-1Syntax from the command contract.
hide request cancel
Section titled “hide request cancel”Cancels a letter you sent that is still waiting for its answer.
hide request ack|cancel|show <id>Example:
hide request cancel letter-1Syntax from the command contract.
hide request show
Section titled “hide request show”Opens one letter in full, including a letter that an inbox bundle only lists by its id.
hide request ack|cancel|show <id>Example:
hide request show letter-1Syntax from the command contract.
hide inbox
Section titled “hide inbox”Lists the letters waiting for you and the ones that came back undelivered, with the command that marks them taken.
hide inbox [--hook [--prompt-digest <sha256>] [--session <id>] [--tool|--turn-end]]Example:
hide inboxSyntax from the command contract.
hide watch start
Section titled “hide watch start”Starts a watch on an agent, so you get a letter when that agent has been quiet for too long or has stopped at a question or a prompt; the watch ends when the agent exits, reports that it is finished, or you stop it.
hide watch start <target> [--observer <id>] [--actor <id>]Example:
hide watch start child-name| Option | Needed | Value |
|---|---|---|
--observer |
no | key |
--actor |
no | key |
Syntax from the command contract.
hide watch assign
Section titled “hide watch assign”Hands a watch to another observer, so its quiet-time letters go to the new one; the current observer can hand it over, and an observer can take it for itself by naming itself with —approval and the watch’s current —expected-generation.
hide watch assign <watch-or-target-id> --observer <id> [--actor <id>] [--expected-generation <n>] [--approval <text>]Example:
hide watch assign watch-2 --observer agent-2| Option | Needed | Value |
|---|---|---|
--observer |
yes | key |
--actor |
no | key |
--expected-generation |
no | unsigned |
--approval |
no | approval |
Syntax from the command contract.
hide watch stop
Section titled “hide watch stop”Stops a watch, so its observer no longer gets letters about that agent.
hide watch stop <id>Example:
hide watch stop watch-2Syntax from the command contract.
hide watch list
Section titled “hide watch list”Lists the watches that are running and who observes each one.
hide watch listExample:
hide watch listSyntax from the command contract.
Agents
Section titled “Agents”hide agent register
Section titled “hide agent register”Adds an agent that you started yourself in a Hide pane to Hide’s list of agents, with the parent you name if you name one.
hide agent register [--check] [--machine <device id>] --host-scope <scope> --session <session> --instance <terminal> --name <name> --pane <pane> [--parent <id>] [--project <path>]| Option | Needed | Value |
|---|---|---|
--check |
no | flag |
--machine |
no | text |
--host-scope |
yes | text |
--session |
yes | session |
--instance |
yes | text |
--name |
yes | text |
--pane |
yes | text |
--parent |
no | text |
--project |
no | text |
--json |
no | flag |
Syntax from the command contract.
hide agent list
Section titled “hide agent list”Lists the agents Hide knows, with the machine each runs on and whether it is running, asleep or ended.
hide agent list [--live]Example:
hide agent list| Option | Needed | Value |
|---|---|---|
--live |
no | flag |
--json |
no | flag |
Syntax from the command contract.
hide agent show
Section titled “hide agent show”Shows one agent: its id, its parent, its machine, and what it is doing and waiting on now.
hide agent show <id|name|pane|here>Example:
hide agent show here| Option | Needed | Value |
|---|---|---|
--json |
no | flag |
Can be refused as: agent_unavailable, target_ambiguous.
Syntax from the command contract.
hide agent ask-human
Section titled “hide agent ask-human”Tells the operator that a step needs a person, such as a sign-in or a permission; you then end your turn and wait for the letter that says it is done.
hide agent ask-human <auth|permission> <where>Example:
hide agent ask-human auth https://github.com/login| Option | Needed | Value |
|---|---|---|
--json |
no | flag |
Can be refused as: human_kind_unknown, human_place_required, human_place_too_long, agent_pane_required, participant_unavailable, participant_registering, participant_ended, participant_session_changed, ambiguous_participant.
Syntax from the command contract.
hide agent end
Section titled “hide agent end”Ends an agent and closes its pane, keeping its conversation so the operator can resume it; with —keep-pane only the agent’s registration ends, and to end yourself you need —keep-pane, since otherwise your own pane closes before the command gets its answer.
hide agent end <id> [--actor <id>] [--keep-pane]Example:
hide agent end agent-7| Option | Needed | Value |
|---|---|---|
--actor |
no | text |
--keep-pane |
no | flag |
--json |
no | flag |
Can be refused as: agent_unavailable, parent_authority_required, actor_identity_conflict, machine_unavailable, pane_close_failed.
Syntax from the command contract.
hide agent sleep
Section titled “hide agent sleep”Puts a child of yours (or yourself) to sleep, its process ending and its conversation kept, so a request or block letter wakes it again; it is refused while the agent works, waits for the operator or is on the operator’s screen.
hide agent sleep <id> [--actor <id>]Example:
hide agent sleep agent-7| Option | Needed | Value |
|---|---|---|
--actor |
no | text |
--json |
no | flag |
Can be refused as: agent_pane_required, agent_unavailable, agent_ended, parent_authority_required, actor_identity_conflict, agent_sleep_unsupported, agent_sleep_core_machine_only, agent_sleep_working, agent_sleep_waiting_for_you, agent_sleep_activity_unknown, agent_sleep_no_conversation, agent_sleep_on_screen, agent_sleep_waking, agent_sleep_unreachable, agent_sleep_busy, agent_sleep_not_started.
Syntax from the command contract.
hide agent archive
Section titled “hide agent archive”Saves an agent’s conversation and closes its panes, so the operator can resume it later from the archive; a session that is working is refused, and only the operator confirms that, on Hide’s screen.
hide agent archive <id> [--actor <id>]Example:
hide agent archive agent-7| Option | Needed | Value |
|---|---|---|
--actor |
no | text |
--json |
no | flag |
Can be refused as: agent_pane_required, agent_unavailable, agent_ended, parent_authority_required, actor_identity_conflict, archive_confirmation_required, archive_not_offered, archive_delegated, archive_device_disconnected, archive_session_unknown, archive_status_unknown, archive_target_unknown, archive_too_many, archive_busy, archive_context_unavailable, archive_full.
Syntax from the command contract.
hide agent catalog
Section titled “hide agent catalog”Lists the agent kinds and profiles Hide can start, with whether each is installed and the models and efforts each one takes.
hide agent catalog [--machine <device id>]Example:
hide agent catalog| Option | Needed | Value |
|---|---|---|
--machine |
no | text |
--json |
no | flag |
Syntax from the command contract.
hide agent profile list
Section titled “hide agent profile list”Lists this machine’s agent profiles, each one a way to start an agent, with its account, program, environment variable names and installation state.
hide agent profile list|add|edit|default|remove|reinstall … (hide agent profile --help)Example:
hide agent profile list| Option | Needed | Value |
|---|---|---|
--kind |
no | text |
--machine |
no | text |
--json |
no | flag |
Can be refused as: profile_refused, profile_in_use, profile_gone, profile_builtin, profiles_unsupported, profiles_unread, profile_unanswered, profile_invalid, profile_busy, machine_unknown, machine_unavailable.
Syntax from the command contract.
hide agent profile add
Section titled “hide agent profile add”Adds a profile for an agent kind, such as a second account with its own folder, that a start can then choose with —profile.
hide agent profile list|add|edit|default|remove|reinstall … (hide agent profile --help)Example:
hide agent profile add claude work --account ~/.claude-work| Option | Needed | Value |
|---|---|---|
--account |
no | text |
--program |
no | text |
--env |
no | text |
--default |
no | flag |
--machine |
no | text |
--json |
no | flag |
Can be refused as: profile_refused, profile_in_use, profile_gone, profile_builtin, profiles_unsupported, profiles_unread, profile_unanswered, profile_invalid, profile_busy, machine_unknown, machine_unavailable.
Syntax from the command contract.
hide agent profile edit
Section titled “hide agent profile edit”Changes a profile’s name, program or environment variables; the built-in default profile cannot be edited.
hide agent profile list|add|edit|default|remove|reinstall … (hide agent profile --help)Example:
hide agent profile edit claude work --rename client| Option | Needed | Value |
|---|---|---|
--rename |
no | text |
--program |
no | text |
--no-program |
no | flag |
--env |
no | text |
--unset-env |
no | text |
--machine |
no | text |
--json |
no | flag |
Can be refused as: profile_refused, profile_in_use, profile_gone, profile_builtin, profiles_unsupported, profiles_unread, profile_unanswered, profile_invalid, profile_busy, machine_unknown, machine_unavailable.
Syntax from the command contract.
hide agent profile default
Section titled “hide agent profile default”Makes a profile the one an agent starts with when nothing else chooses a profile.
hide agent profile list|add|edit|default|remove|reinstall … (hide agent profile --help)Example:
hide agent profile default claude work| Option | Needed | Value |
|---|---|---|
--machine |
no | text |
--json |
no | flag |
Can be refused as: profile_refused, profile_in_use, profile_gone, profile_builtin, profiles_unsupported, profiles_unread, profile_unanswered, profile_invalid, profile_busy, machine_unknown, machine_unavailable.
Syntax from the command contract.
hide agent profile remove
Section titled “hide agent profile remove”Removes a profile that no running or sleeping agent uses; the built-in default profile cannot be removed.
hide agent profile list|add|edit|default|remove|reinstall … (hide agent profile --help)Example:
hide agent profile remove claude work| Option | Needed | Value |
|---|---|---|
--machine |
no | text |
--json |
no | flag |
Can be refused as: profile_refused, profile_in_use, profile_gone, profile_builtin, profiles_unsupported, profiles_unread, profile_unanswered, profile_invalid, profile_busy, machine_unknown, machine_unavailable.
Syntax from the command contract.
hide agent profile reinstall
Section titled “hide agent profile reinstall”Installs Hide’s hooks into a profile’s account folder again.
hide agent profile list|add|edit|default|remove|reinstall … (hide agent profile --help)Example:
hide agent profile reinstall claude work| Option | Needed | Value |
|---|---|---|
--machine |
no | text |
--json |
no | flag |
Can be refused as: profile_refused, profile_in_use, profile_gone, profile_builtin, profiles_unsupported, profiles_unread, profile_unanswered, profile_invalid, profile_busy, machine_unknown, machine_unavailable.
Syntax from the command contract.
hide agent spawn
Section titled “hide agent spawn”Starts a new agent in a tab of its own, or beside your pane with —beside (your own checkout only), and gives it a brief to start on; —machine starts it on a device, and only the machine that runs Hide may do that.
hide agent spawn [--parent <here|id>] [--machine <device id>] [--beside] --name <name> (--intent <key> | --plan-node <key>) --kind <kind> [--repo <path> [--branch <branch> [--path <path>]]] [--profile <name>] [--model <model>] [--effort <effort>] [--brief <text> | --brief-file <path>] [-- <native args>]Example:
hide agent spawn --parent here --name review-1 --intent review-1 --kind claude --repo ~/projects/app --branch review-1 --brief 'Review the diff and report.'| Option | Needed | Value |
|---|---|---|
--parent |
no | text |
--machine |
no | text |
--beside |
no | flag |
--name |
yes | text |
--intent |
no | text |
--plan-node |
no | key |
--kind |
yes | text |
--repo |
no | text |
--branch |
no | text |
--path |
no | text |
--profile |
no | text |
--model |
no | text |
--effort |
no | text |
--brief |
no | text |
--brief-file |
no | text |
--help |
no | flag |
--json |
no | flag |
Can be refused as: spawn_busy, machine_unknown, machine_not_permitted, machine_unavailable, repository_unavailable, spawn_repo_required, spawn_project_loading, spawn_folder_unreadable, agent_not_installed, agent_hook_off, agent_not_set_up, agent_hook_untrusted, agent_hook_missing, agent_hook_unconfirmed, agent_hook_unchecked, intent_conflict, invalid_launch_choice, shell_starting, holder_cap, pane_busy, agent_not_started, worktree_unconfirmed, native_identity_unavailable, identity_waits_full, session_too_long, codex_capability_unknown, invalid_brief, invalid_agent_name, brief_not_submitted, mission_brief_missing, mission_node_held, mission_gate_before_start, mission_machine_node_refused, mission_other_repository, mission_machine_unavailable, mission_projects_loading, mission_machine_no_repository, beside_other_checkout, beside_other_machine, beside_needs_agent_pane, beside_with_parent, beside_pane_unavailable, plan_missing, plan_node_unknown, plan_node_finished, plan_delegate_needs_parent, plan_order_refused, plan_review_pending, plan_candidate_refused, plan_delegate_full, plan_delegate_not_permitted, plan_unavailable, plan_session_unknown, profile_gone, profiles_unsupported, profile_refused, profile_unanswered, profile_unconfirmed, launch_records_full.
Syntax from the command contract.
hide ps
Section titled “hide ps”Shows the panes and agents Hide runs, as a tree of checkouts, tabs and panes; —here keeps only this project.
hide ps [--all] [--here] [--json]Example:
hide ps --here| Option | Needed | Value |
|---|---|---|
--all |
no | flag |
--here |
no | flag |
--json |
no | flag |
Can be refused as: here_unavailable, ps_answer_unreadable.
Syntax from the command contract.
hide agent read
Section titled “hide agent read”Prints the last lines of an agent’s pane, so you can see what the agent last showed.
hide agent read <agent> [--lines <n>] [--json]Example:
hide agent read agent-7 --lines 40| Option | Needed | Value |
|---|---|---|
--lines |
no | unsigned |
--json |
no | flag |
Can be refused as: pane_required, lines_out_of_range, agent_unavailable, target_ambiguous.
Syntax from the command contract.
Missions
Section titled “Missions”hide mission help
Section titled “hide mission help”Prints the guide for a mission’s Conductor, the agent that plans a mission and starts the agents that do its work.
hide mission helpExample:
hide mission helpSyntax from hide --help; not in the command contract.
hide mission create
Section titled “hide mission create”Creates a new mission with a title, which a plan and its agents then carry out.
hide mission create --title <title> [--scope pr|merge] [--cap <n>] [--github <account>]Example:
hide mission create --title 'Fix the lens filter'| Option | Needed | Value |
|---|---|---|
--title |
yes | text |
--scope |
no | one_of |
--cap |
no | unsigned |
--github |
no | text |
Can be refused as: mission_already_conducting, mission_full, mission_projects_loading, mission_project_unknown, mission_cap_out_of_range.
Syntax from the command contract.
hide mission plan
Section titled “hide mission plan”Sets a mission’s plan from a JSON file: its nodes, their order, their checks and the worker for each.
hide mission plan [--mission <id>] (--file <plan.json> | --json <plan>)Example:
hide mission plan --file plan.json| Option | Needed | Value |
|---|---|---|
--mission |
no | key |
--file |
no | text |
--json |
no | json |
Can be refused as: mission_plan_invalid, mission_not_conductor, mission_closed, mission_cancelled, mission_too_many_nodes, mission_node_in_progress, mission_dependency_unknown, mission_dependency_cycle, mission_criteria_missing, mission_criteria_too_many, mission_steps_invalid, mission_checkers_invalid, mission_external_invalid, mission_destination_invalid, mission_needs_git, mission_operator_merge_invalid, mission_preset_invalid, mission_gate_node_started, mission_machine_node_refused, mission_profile_unknown, mission_candidate_refused.
Syntax from the command contract.
hide mission node
Section titled “hide mission node”Updates one node of a mission’s plan, such as its status, its branch, its pull request or its worker.
hide mission node <key> [--mission <id>] [--status <status>] [--agent-id <id> | --no-agent-id] [--pr <n> | --no-pr] [--base-pr <n> | --no-base-pr] [--branch <name> | --no-branch] [--attempts <n>] [--line <text> | --no-line] [--change <text> | --no-change] [--review <text> | --no-review] [--commit <sha> | --no-commit] [--verdict pass|fail | --no-verdict] [--checks <passed>/<total> | --no-checks]Example:
hide mission node fix-1487 --status working --agent-id agent-7| Option | Needed | Value |
|---|---|---|
--mission |
no | key |
--status |
no | one_of |
--agent-id |
no | key |
--pr |
no | unsigned |
--base-pr |
no | unsigned |
--branch |
no | text |
--attempts |
no | unsigned |
--line |
no | text |
--change |
no | text |
--review |
no | text |
--commit |
no | commit |
--verdict |
no | one_of |
--checks |
no | ratio |
--no-agent-id |
no | flag |
--no-pr |
no | flag |
--no-base-pr |
no | flag |
--no-branch |
no | flag |
--no-line |
no | flag |
--no-change |
no | flag |
--no-review |
no | flag |
--no-commit |
no | flag |
--no-verdict |
no | flag |
--no-checks |
no | flag |
--reviewer |
no | key |
--verifier |
no | key |
--hold |
no | text |
--for |
no | span |
--no-hold |
no | flag |
Can be refused as: mission_node_held, mission_node_started, mission_gate_before_start, mission_node_unknown, mission_not_conductor, mission_ambiguous, mission_closed, mission_criteria_unmet, mission_checker_is_worker, mission_checker_unknown, mission_external_invalid, mission_machine_node_refused, mission_machine_unavailable, mission_projects_loading, mission_machine_no_repository.
Syntax from the command contract.
hide mission record
Section titled “hide mission record”Records one finish line of a node as passed or failed, with the evidence that shows it.
hide mission record <node> <line> [--mission <id>] (--pass | --fail) --evidence <text> [--commit <sha>] [--rerun]Example:
hide mission record fix-1487 c1 --pass --evidence 'The lens keeps its filter after a reload.'| Option | Needed | Value |
|---|---|---|
--mission |
no | key |
--pass |
no | flag |
--fail |
no | flag |
--evidence |
yes | text |
--summary |
no | text |
--commit |
no | commit |
--rerun |
no | flag |
Can be refused as: mission_node_unknown, mission_criterion_unknown, mission_criterion_not_yours, participant_session_changed, participant_registering, participant_unavailable, ledger_unavailable, mission_ambiguous, mission_commit_required, mission_rerun_spent, mission_evidence_missing, mission_summary_invalid, mission_checkout_unknown, mission_closed.
Syntax from the command contract.
hide mission skip
Section titled “hide mission skip”Marks one finish line of a node as skipped, with a reason, so the node can go on.
hide mission skip <node> <line> [--mission <id>] --reason <text> [--decision <key>]Example:
hide mission skip cause c2 --reason 'Covered by the next node.'| Option | Needed | Value |
|---|---|---|
--mission |
no | key |
--reason |
yes | text |
--decision |
no | unsigned |
Can be refused as: mission_not_conductor, mission_node_unknown, mission_criterion_unknown, mission_ambiguous, mission_skip_reason_missing, mission_criteria_protected.
Syntax from the command contract.
hide mission defect
Section titled “hide mission defect”Reopens an earlier node with a defect that a later node found, so its worker can fix it.
hide mission defect <node> [--mission <id>] --found-by <node> --line <text>Example:
hide mission defect fix-1487 --found-by together --line 'The lens loses its filter after a reload.'| Option | Needed | Value |
|---|---|---|
--mission |
no | key |
--found-by |
yes | key |
--line |
yes | text |
Can be refused as: mission_not_conductor, mission_node_unknown, mission_external_invalid, mission_defects_too_many.
Syntax from the command contract.
hide mission gate
Section titled “hide mission gate”Settles a place the operator asked to check, using the operator’s own words, so the node can finish.
hide mission gate <node> [--mission <id>] ((--pass | --fix) --said <the operator's words> | --show <view-id|path>...)Example:
hide mission gate fix-1487 --pass --said 'looks good'| Option | Needed | Value |
|---|---|---|
--mission |
no | key |
--pass |
no | flag |
--fix |
no | flag |
--said |
no | text |
--show |
no | text |
Can be refused as: mission_not_conductor, mission_node_unknown, mission_gate_none, mission_gate_not_open, mission_gate_passed, mission_gate_words_missing, mission_closed.
Syntax from the command contract.
hide mission start
Section titled “hide mission start”Moves a planned mission from Planning to Running once the operator has approved its plan; the Conductor then starts the workers.
hide mission start [--mission <id>]Example:
hide mission start| Option | Needed | Value |
|---|---|---|
--mission |
no | key |
Syntax from the command contract.
hide mission decide
Section titled “hide mission decide”Puts a question for the operator on the mission’s map, or clears it with —clear once it is answered.
hide mission decide [--mission <id>] (--line <text> [--why <text>] [--option <text>]... [--recommend <n>] [--node <key>]... [--show <view-id|path>]... | --clear)Example:
hide mission decide --line 'Ship the lens fix in this pull request?' --option yes --option no| Option | Needed | Value |
|---|---|---|
--mission |
no | key |
--line |
no | text |
--clear |
no | flag |
--why |
no | text |
--option |
no | text |
--recommend |
no | unsigned |
--node |
no | key |
--show |
no | text |
Syntax from the command contract.
hide mission delay
Section titled “hide mission delay”Records why new starts are held for a mission, such as usage near a limit; holding them is the Conductor’s job, and —clear removes the reason.
hide mission delay [--mission <id>] (--line <text> --for <30m|2h> | --clear)Example:
hide mission delay --line 'Usage is close to the limit.'| Option | Needed | Value |
|---|---|---|
--mission |
no | key |
--line |
no | text |
--for |
no | span |
--clear |
no | flag |
Syntax from the command contract.
hide mission close
Section titled “hide mission close”Closes a mission as done, as waiting for merge, or as cancelled, with a report of what it did.
hide mission close [--mission <id>] --as done|merge_wait|cancelled [--report <text> | --report-file <path>]Example:
hide mission close --as done --report-file report.md| Option | Needed | Value |
|---|---|---|
--mission |
no | key |
--as |
yes | one_of |
--report |
no | text |
--report-file |
no | text |
Can be refused as: mission_nodes_unfinished, mission_criteria_unmet, mission_not_started, mission_cancelled.
Syntax from the command contract.
hide mission reopen
Section titled “hide mission reopen”Opens a mission that was closed as done or as waiting for merge again, so its nodes can continue; a cancelled mission cannot be reopened.
hide mission reopen [--mission <id>]Example:
hide mission reopen| Option | Needed | Value |
|---|---|---|
--mission |
no | key |
Syntax from the command contract.
hide mission take
Section titled “hide mission take”Takes over a mission whose Conductor is gone, so you become the one that runs its plan.
hide mission take <id> [--handover <token>]Example:
hide mission take mission-3| Option | Needed | Value |
|---|---|---|
--handover |
no | text |
Can be refused as: mission_conducted, mission_cancelled, mission_other_project.
Syntax from the command contract.
hide mission show
Section titled “hide mission show”Shows a mission as text, or one node in full, or the whole record as JSON with —json.
hide mission show [<node-or-mission-id>] [--mission <id>] [--json]Example:
hide mission show| Option | Needed | Value |
|---|---|---|
--mission |
no | key |
--json |
no | flag |
Can be refused as: mission_node_unknown, mission_ambiguous.
Syntax from the command contract.
hide mission list
Section titled “hide mission list”Lists the missions in this Hide, with their status and their Conductor.
hide mission listExample:
hide mission listSyntax from the command contract.
hide mission settings
Section titled “hide mission settings”Shows the mission defaults: how many agents may run at once, the default scope and the worker candidates.
hide mission settingsExample:
hide mission settingsSyntax from the command contract.
hide task help
Section titled “hide task help”Prints the guide for keeping your own plan of steps, which Hide shows as a map beside your pane.
hide task helpExample:
hide task helpSyntax from hide --help; not in the command contract.
hide task set
Section titled “hide task set”Puts up the steps of your task, so the operator can see where you are on the map beside your pane.
hide task set (--file <plan.json> | --json <plan>) [--ask [why]] [--reason <text>]Example:
hide task set --file plan.json| Option | Needed | Value |
|---|---|---|
--file |
no | text |
--json |
no | json |
--ask |
no | flag |
--reason |
no | text |
Can be refused as: plan_invalid, plan_order_refused, plan_too_large, plan_full, plan_unavailable, plan_session_unknown, plan_evidence_missing, plan_pr_not_yours, plan_pr_unconfirmed, plan_file_outside, plan_file_missing, plan_file_unconfirmed, plan_report_missing.
Syntax from the command contract.
hide task node
Section titled “hide task node”Changes one step of your plan: its status, a line about it, or the pull request or file that finishes it.
hide task node <key> [--status planned|working|done|dropped] [--line <text>] [--pr <number> | --file <path>]Example:
hide task node spec --status done --file docs/spec.md| Option | Needed | Value |
|---|---|---|
--status |
no | one_of |
--line |
no | text |
--pr |
no | unsigned |
--file |
no | text |
Can be refused as: plan_missing, plan_node_unknown, plan_order_refused, plan_evidence_missing, plan_pr_not_yours, plan_pr_unconfirmed, plan_file_outside, plan_file_missing, plan_file_unconfirmed, plan_report_missing.
Syntax from the command contract.
hide task approve
Section titled “hide task approve”Records that the operator approved the plan you put up for review, so your writes, commits and pushes are allowed again.
hide task approve [<agent>]Example:
hide task approveCan be refused as: plan_missing, plan_not_yours, plan_agent_unknown.
Syntax from the command contract.
hide task drop
Section titled “hide task drop”Drops a plan the operator asked you not to carry out.
hide task drop [<agent>]Example:
hide task dropCan be refused as: plan_not_yours, plan_agent_unknown.
Syntax from the command contract.
hide task show
Section titled “hide task show”Shows an agent’s plan, with the status of each of its steps.
hide task show [<agent>]Example:
hide task showCan be refused as: plan_agent_unknown.
Syntax from the command contract.
Panes and workspaces
Section titled “Panes and workspaces”hide pane read
Section titled “hide pane read”Prints the last lines of a pane, unwrapped, so you can see what its program last showed.
hide pane read <pane> [--lines <n>] [--json]Example:
hide pane read w1:p2 --lines 20| Option | Needed | Value |
|---|---|---|
--lines |
no | unsigned |
--source |
no | one_of |
--format |
no | one_of |
--json |
no | flag |
Can be refused as: pane_required, lines_out_of_range, pane_unavailable, guest_pane_read.
Syntax from the command contract.
hide pane send
Section titled “hide pane send”Types text into a pane, or presses keys in it such as Escape or Enter; it is refused while the pane’s input box holds a draft that someone typed there, and it is input, not a letter, so nothing keeps a reply or retries it.
hide pane send <pane> [<text>] [--key <name>]... [--enter] [--paste]Example:
hide pane send w1:p2 --key esc| Option | Needed | Value |
|---|---|---|
--key |
no | one_of |
--enter |
no | flag |
--paste |
no | flag |
Can be refused as: pane_required, nothing_to_send, text_empty, text_invalid, text_too_long, too_many_keys, paste_unsupported, pane_unavailable, pane_asleep, composer_not_empty, keys_not_sent, send_unconfirmed, operator_typing, guest_pane_keys.
Syntax from the command contract.
hide pane open
Section titled “hide pane open”Opens a new pane beside your own pane, in your checkout, and runs a command in it, without moving your keyboard focus unless you add —focus.
hide pane open --beside [--focus] -- <command>Example:
hide pane open --beside -- npm run dev| Option | Needed | Value |
|---|---|---|
--beside |
yes | flag |
--focus |
no | flag |
Can be refused as: pane_required, command_invalid, command_too_long, pane_unavailable, pane_open_unconfirmed, shell_not_ready.
Syntax from the command contract.
hide workspace purpose
Section titled “hide workspace purpose”Sets the one-line purpose of the checkout you run it in, which the sidebar shows; it can be 40 characters at most, and an empty text clears it.
hide workspace purpose <text>Example:
hide workspace purpose 'Fix the lens filter'Can be refused as: pane_required, purpose_invalid, purpose_too_long, purpose_no_workspace, purpose_checkout_unlisted.
Syntax from the command contract.
hide workspace info
Section titled “hide workspace info”Shows the workspace and checkout Hide has for this folder, and the device they run on.
hide workspace infoExample:
hide workspace infoSyntax from hide --help; not in the command contract.
The operator’s screen
Section titled “The operator’s screen”hide file open
Section titled “hide file open”Shows a file to the operator in Hide’s View as a tab, where it waits until they look at it; it needs Hide’s window open, and while the operator is looking at another pane of your checkout, the file waits in your session’s Files list instead of taking the screen. A program outside Hide’s panes and outside every project names the project with —repo
hide file open <path> [--repo <folder>] [--request-id <id>]Example:
hide file open docs/spec.mdSyntax from hide --help; not in the command contract.
hide diff open
Section titled “hide diff open”Shows the changes to a file to the operator in Hide’s View as a tab, where it waits until they look at it; it needs Hide’s window open, and while the operator is looking at another pane of your checkout, it waits in your session’s Files list instead of taking the screen. A program outside Hide’s panes and outside every project names the project with —repo
hide diff open <path> [--repo <folder>] [--request-id <id>]Example:
hide diff open src/lens.rsSyntax from hide --help; not in the command contract.
hide browser open
Section titled “hide browser open”Opens a web page, or a local file, as a browser tab in Hide’s View, where it waits until the operator looks at it; it needs Hide’s window open, and while the operator is looking at another pane of your checkout, the tab waits behind what they see. Only an http(s) or blank page can be driven by the other browser commands. A program outside Hide’s panes and outside every project names the project with —repo
hide browser open <url-or-path> [--wait] [--request-id <id>]Example:
hide browser open http://localhost:3000Syntax from hide --help; not in the command contract.
hide browser connect
Section titled “hide browser connect”Asks Hide for the browser display of this checkout, or the one you name with —display, and prints its answer.
hide browser connect [--display <id>]Example:
hide browser connectSyntax from hide --help; not in the command contract.
hide browser snapshot
Section titled “hide browser snapshot”Reads the page in one of your own checkout’s browser displays as a list of its elements, each with a ref you can act on; it also works while the display is behind another tab of its area.
hide browser snapshot|click|fill|type|press|hover|drag|scroll|wait|screenshot|eval|console|network <display> ...Example:
hide browser snapshot browser-3 --interactiveSyntax from hide --help; not in the command contract.
hide browser click
Section titled “hide browser click”Clicks an element of the page, by its ref, by its visible text, or by a point, only while its View is the selected one of its area; behind another tab it fails with display_hidden.
hide browser snapshot|click|fill|type|press|hover|drag|scroll|wait|screenshot|eval|console|network <display> ...Example:
hide browser click browser-3 @5Syntax from hide --help; not in the command contract.
hide browser fill
Section titled “hide browser fill”Fills a form field of the page with a value.
hide browser snapshot|click|fill|type|press|hover|drag|scroll|wait|screenshot|eval|console|network <display> ...Example:
hide browser fill browser-3 @1 'a@b.c'Syntax from hide --help; not in the command contract.
hide browser type
Section titled “hide browser type”Types text into the page, only while its View is the selected one of its area; behind another tab it fails with display_hidden.
hide browser snapshot|click|fill|type|press|hover|drag|scroll|wait|screenshot|eval|console|network <display> ...Example:
hide browser type browser-3 'hello'Syntax from hide --help; not in the command contract.
hide browser press
Section titled “hide browser press”Presses a key in the page, such as Enter, Tab or Escape, only while its View is the selected one of its area; behind another tab it fails with display_hidden.
hide browser snapshot|click|fill|type|press|hover|drag|scroll|wait|screenshot|eval|console|network <display> ...Example:
hide browser press browser-3 EnterSyntax from hide --help; not in the command contract.
hide browser hover
Section titled “hide browser hover”Moves the pointer over an element of the page, so a menu or tooltip can show, only while its View is the selected one of its area; behind another tab it fails with display_hidden.
hide browser snapshot|click|fill|type|press|hover|drag|scroll|wait|screenshot|eval|console|network <display> ...Example:
hide browser hover browser-3 @3Syntax from hide --help; not in the command contract.
hide browser drag
Section titled “hide browser drag”Drags from one element or point of the page to another, only while its View is the selected one of its area; behind another tab it fails with display_hidden.
hide browser snapshot|click|fill|type|press|hover|drag|scroll|wait|screenshot|eval|console|network <display> ...Example:
hide browser drag browser-3 @2 @7Syntax from hide --help; not in the command contract.
hide browser scroll
Section titled “hide browser scroll”Scrolls the page up or down, or to an element.
hide browser snapshot|click|fill|type|press|hover|drag|scroll|wait|screenshot|eval|console|network <display> ...Example:
hide browser scroll browser-3 downSyntax from hide --help; not in the command contract.
hide browser wait
Section titled “hide browser wait”Waits until a text or an element appears in the page; with —gone and a selector it waits until that element disappears instead. It stops at a timeout.
hide browser snapshot|click|fill|type|press|hover|drag|scroll|wait|screenshot|eval|console|network <display> ...Example:
hide browser wait browser-3 --text 'Welcome'Syntax from hide --help; not in the command contract.
hide browser screenshot
Section titled “hide browser screenshot”Saves a picture of the page, or of one element with —ref, to a file, only while its View is the selected one of its area; behind another tab it fails with display_hidden.
hide browser snapshot|click|fill|type|press|hover|drag|scroll|wait|screenshot|eval|console|network <display> ...Example:
hide browser screenshot browser-3 shot.pngSyntax from hide --help; not in the command contract.
hide browser eval
Section titled “hide browser eval”Runs a JavaScript expression in the page and prints its result.
hide browser snapshot|click|fill|type|press|hover|drag|scroll|wait|screenshot|eval|console|network <display> ...Example:
hide browser eval browser-3 'document.title'Syntax from hide --help; not in the command contract.
hide browser console
Section titled “hide browser console”Shows the messages the page logged to its console, newest first.
hide browser snapshot|click|fill|type|press|hover|drag|scroll|wait|screenshot|eval|console|network <display> ...Example:
hide browser console browser-3Syntax from hide --help; not in the command contract.
hide browser network
Section titled “hide browser network”Shows the network requests the page made, with their timing but not their headers or bodies.
hide browser snapshot|click|fill|type|press|hover|drag|scroll|wait|screenshot|eval|console|network <display> ...Example:
hide browser network browser-3Syntax from hide --help; not in the command contract.
hide browser help
Section titled “hide browser help”Prints the guide for driving a browser display: its refs, how actions are checked, and what each failure means.
hide browser helpExample:
hide browser helpSyntax from hide --help; not in the command contract.
hide view list
Section titled “hide view list”Lists the Views open in your checkout, with the ids that the other view and browser commands take.
hide view list [--session <id|here>]Example:
hide view listSyntax from hide --help; not in the command contract.
hide view status
Section titled “hide view status”Shows one View by its id, so you can read what a delegated agent opened in it.
hide view status <view-id>Example:
hide view status browser-3Syntax from hide --help; not in the command contract.
hide view select
Section titled “hide view select”Brings a View to the front of its area when the operator is looking at your pane. If they are looking at another pane of the same checkout, the command succeeds but their selection stays as it was.
hide view select <view-id> [--request-id <id>]Example:
hide view select browser-3Syntax from hide --help; not in the command contract.
hide view close
Section titled “hide view close”Closes a View, so it leaves the operator’s screen; the last View of a document with an unsaved draft is refused until the operator saves or discards the draft in Hide.
hide view close <view-id> [--request-id <id>]Example:
hide view close browser-3Syntax from hide --help; not in the command contract.
hide view split
Section titled “hide view split”Moves a View into a new area on one edge of the area you name, so it sits beside the others; the result may not have more than six areas or three levels of splits, and a View alone in its area cannot be split off from that same area.
hide view split <view-id> --area <area-id> --edge left|right|up|down [--request-id <id>]Example:
hide view split browser-3 --area area-1 --edge rightSyntax from hide --help; not in the command contract.
hide view move
Section titled “hide view move”Moves a View into another area, at the position you give.
hide view move <view-id> --area <area-id> --index <n> [--request-id <id>]Example:
hide view move browser-3 --area area-2 --index 0Syntax from hide --help; not in the command contract.
Devices
Section titled “Devices”hide device list
Section titled “hide device list”Lists the machines connected to this Hide: the Hides it is paired with, each with who opens whom and whether the two are connected, and its SSH devices, each with its state and whatever it is waiting on from you; run it on the machine that runs Hide, since a device is refused.
hide device list [--json]Example:
hide device list| Option | Needed | Value |
|---|---|---|
--json |
no | flag |
Can be refused as: machine_not_permitted.
Syntax from the command contract.
hide device share
Section titled “hide device share”Prints a link that lets one other Hide open this machine: it works once, for nine minutes, and ends when the command does. When that machine pastes it, the command shows four words to compare with its screen and takes your yes or no, then waits until it is let in. Only the operator may run it, in a terminal outside Hide’s panes.
hide device share [--json]Example:
hide device share| Option | Needed | Value |
|---|---|---|
--json |
no | flag |
Can be refused as: device_from_pane, peer_unavailable, pairing_ended.
Syntax from the command contract.
hide device add
Section titled “hide device add”With a link another Hide shared, pairs with that machine: the command shows four words, takes your yes or no once you have compared them with the other screen, and waits for that machine’s operator to allow it; only the operator may run it, outside Hide’s panes. With a Host name from ~/.ssh/config, adds a computer you reach over SSH: one that already runs its own Hide is connected to as a Hide, with no words and nothing installed there, when ssh signs in without asking and the command runs outside Hide’s panes; any other is registered as a device, and nothing is installed until the operator chooses Allow and install on its row in Settings > Devices.
hide device add <link or ssh alias> [--name <name>] [--json]Example:
hide device add mini --name 'Mac mini'| Option | Needed | Value |
|---|---|---|
--name |
no | text |
--json |
no | flag |
Can be refused as: machine_not_permitted, device_invalid, device_duplicate, device_from_pane, link_invalid, link_newer, link_own, device_already_connected, pairing_no_offer, pairing_declined, pairing_host_full, pairing_full, pairing_unanswered, pairing_unreachable, pairing_update_needed, pairing_ended, ssh_hide_absent, ssh_update_there, ssh_hide_not_running, ssh_not_reached, ssh_busy, device_own, device_limit, peer_unavailable.
Syntax from the command contract.
hide device allow
Section titled “hide device allow”Answers, at this terminal, the machines that wait for this machine’s operator: each is shown with what it would be allowed, and takes a yes or no. For a machine with no window to answer in; only the operator may run it, outside Hide’s panes.
hide device allow [--json]Example:
hide device allow| Option | Needed | Value |
|---|---|---|
--json |
no | flag |
Can be refused as: device_from_pane.
Syntax from the command contract.
hide device pause
Section titled “hide device pause”Stops one direction of a paired machine without removing it: its streams end at once and its work keeps running. A machine paired both ways needs —outgoing (this machine opening it), —incoming (it opening this machine) or —both.
hide device pause <device> [--outgoing|--incoming|--both] [--json]Example:
hide device pause mini --incoming| Option | Needed | Value |
|---|---|---|
--outgoing |
no | flag |
--incoming |
no | flag |
--both |
no | flag |
--json |
no | flag |
Can be refused as: device_unknown, device_ambiguous, device_direction_needed.
Syntax from the command contract.
hide device resume
Section titled “hide device resume”Turns a paused direction of a paired machine back on, after which the two connect again by themselves. Only the operator may run it, in a terminal outside Hide’s panes.
hide device resume <device> [--outgoing|--incoming|--both] [--json]Example:
hide device resume mini --incoming| Option | Needed | Value |
|---|---|---|
--outgoing |
no | flag |
--incoming |
no | flag |
--both |
no | flag |
--json |
no | flag |
Can be refused as: device_from_pane, device_unknown, device_ambiguous, device_direction_needed.
Syntax from the command contract.
hide device remove
Section titled “hide device remove”Removes one direction of a paired machine, which then cannot come back in with the same key until it is paired again; what already ran there and what was read cannot be undone, and its work keeps running. For an SSH device, forgets it and takes Hide’s helper off it only if the helper is connected at that moment and no other registered device reaches the same account there.
hide device remove <device> [--outgoing|--incoming|--both] [--json]Example:
hide device remove mini| Option | Needed | Value |
|---|---|---|
--outgoing |
no | flag |
--incoming |
no | flag |
--both |
no | flag |
--json |
no | flag |
Can be refused as: machine_not_permitted, device_unknown, device_ambiguous, device_direction_needed, device_local_remove_denied, device_files_open.
Syntax from the command contract.
hide device request
Section titled “hide device request”Asks a machine that already opens this one to let this machine open it too, over the connection the two share; its operator answers there, and hide device list shows what came of it. Only the operator may run it, outside Hide’s panes.
hide device request <device> [--json]Example:
hide device request mini| Option | Needed | Value |
|---|---|---|
--json |
no | flag |
Can be refused as: device_from_pane, device_unknown, device_ambiguous, device_not_a_guest, device_already_connected, request_waiting.
Syntax from the command contract.
hide device address
Section titled “hide device address”Names an address a paired machine is tried at first, before the addresses it was last reached at and the relay. Only the operator may run it, outside Hide’s panes.
hide device address <device> <ip:port> [--json]Example:
hide device address mini 192.168.0.12:7842| Option | Needed | Value |
|---|---|---|
--json |
no | flag |
Can be refused as: device_from_pane, device_unknown, device_ambiguous.
Syntax from the command contract.
hide device retry
Section titled “hide device retry”Dials a paired machine that is not connected again now. For an SSH device, starts a new attempt to connect it, which may ask the operator; a device that is connected, connecting or waiting on the operator gets no new attempt. With —wait it waits until the SSH device connects, needs the operator, the attempt fails or five minutes pass.
hide device retry <device> [--wait] [--json]Example:
hide device retry mini --wait| Option | Needed | Value |
|---|---|---|
--wait |
no | flag |
--json |
no | flag |
Can be refused as: machine_not_permitted, device_unknown, device_ambiguous, device_dials_in, device_wait_timeout.
Syntax from the command contract.
hide device switch
Section titled “hide device switch”Switches an SSH device to the connection of the Hide on its machine: the two are paired over the device’s saved SSH login with no link and no words, and the device keeps its id, its name and its running terminals. On a machine that runs no Hide of its own it changes nothing and says so; —install then starts one there from this machine’s Hide program, which the device already has. When another computer switched the device first it changes nothing and names that computer; —own-folder then goes on, closing the terminals this machine ran there. Only the operator may run it, outside Hide’s panes.
hide device switch <device> [--install] [--own-folder] [--json]Example:
hide device switch mini| Option | Needed | Value |
|---|---|---|
--install |
no | flag |
--own-folder |
no | flag |
--json |
no | flag |
Can be refused as: device_from_pane, device_unknown, switch_unsupported, switch_running, switch_not_connected, ssh_core_not_started, ssh_not_reached, ssh_busy, ssh_mac_from_mac_only, ssh_mac_signed_out, ssh_update_there, ssh_hide_not_running, device_already_connected.
Syntax from the command contract.
Tools outside Hide
Section titled “Tools outside Hide”hide access request
Section titled “hide access request”Asks the operator to let this program, outside Hide’s panes, use hide, and waits up to ten minutes for the answer in Settings > External tools (—no-wait answers at once); once approved the program’s later hide commands run as it, at View only or Act, with no second request.
hide access request --name <name> [--no-wait] [--json]Example:
hide access request --name nightly-bot| Option | Needed | Value |
|---|---|---|
--name |
yes | key |
--no-wait |
no | flag |
--json |
no | flag |
Can be refused as: access_from_pane, access_refused, access_request_expired, access_revoked, access_limit, access_name_taken, access_key_unreadable.
Syntax from the command contract.
hide access status
Section titled “hide access status”Says where this program’s connection stands (not connected, waiting, connected and at which level, refused or disconnected) without asking anything new.
hide access status [--json]Example:
hide access status --json| Option | Needed | Value |
|---|---|---|
--json |
no | flag |
Can be refused as: access_from_pane, access_ambiguous, access_refused, access_request_expired, access_revoked, access_key_unreadable.
Syntax from the command contract.
hide access leave
Section titled “hide access leave”Disconnects this program, as the operator’s Disconnect does, and removes its key; the agents it started stay the operator’s.
hide access leave [--json]Example:
hide access leave| Option | Needed | Value |
|---|---|---|
--json |
no | flag |
Can be refused as: access_from_pane, access_ambiguous, access_not_connected, access_key_unreadable.
Syntax from the command contract.
hide access list
Section titled “hide access list”Lists the connected tools with their level, last use and the agents and missions they started, and the requests waiting for the operator; a connected tool runs it.
hide access list [--json]Example:
hide access list --json| Option | Needed | Value |
|---|---|---|
--json |
no | flag |
Can be refused as: access_not_connected, access_ambiguous, access_revoked, access_key_unreadable.
Syntax from the command contract.
Past sessions and links
Section titled “Past sessions and links”hide links pr
Section titled “hide links pr”Shows the projects and sessions Hide has linked to a pull request.
hide links pr <number> | issue <number> | branch <name> | session <id> [--all-projects]Example:
hide links pr 2389 --all-projectsSyntax from hide --help; not in the command contract.
hide links issue
Section titled “hide links issue”Shows the sessions and pull requests Hide has linked to a GitHub issue in this project.
hide links pr <number> | issue <number> | branch <name> | session <id> [--all-projects]Syntax from hide --help; not in the command contract.
hide links branch
Section titled “hide links branch”Shows the pull requests and sessions Hide has linked to a Git branch in this project.
hide links pr <number> | issue <number> | branch <name> | session <id> [--all-projects]Example:
hide links branch mainSyntax from hide --help; not in the command contract.
hide links session
Section titled “hide links session”Shows the named session and the pull requests tied to it.
hide links pr <number> | issue <number> | branch <name> | session <id> [--all-projects]Example:
hide links session 03293c41-46c6-4326-98d0-31f2dcce4132Syntax from hide --help; not in the command contract.
hide session list
Section titled “hide session list”Lists the recent sessions of this project, one line each with a summary, and, when Hide knows this project’s repository, those of the projects of the same repository on connected devices.
hide session list [--since <n>m|h|d] [--limit <n>] [--json]Example:
hide session list --since 1d --limit 10Syntax from hide --help; not in the command contract.
hide session record
Section titled “hide session record”Shows one session as its record: its summary, its state and the requests it received.
hide session record <id> [--json]Example:
hide session record agent-7Syntax from hide --help; not in the command contract.
hide session read
Section titled “hide session read”Reads the raw events of a session around one request, for when the exact words or tool output matter.
hide session read <id> --request <n> | --from <n> [--events <n>] [--json]Example:
hide session read agent-7 --request 3Syntax from hide --help; not in the command contract.
hide session fold-ask
Section titled “hide session fold-ask”Folds one of your own session’s open questions that the work settled, with the reason; it leaves Needs You and stays under Settled, where the operator can open it again.
hide session fold-ask <id> --reason <text> [--json]Example:
hide session fold-ask missed-412-0 --reason "The operator merged the pull request"| Option | Needed | Value |
|---|---|---|
--reason |
yes | text |
--json |
no | flag |
Can be refused as: ask_unknown, ask_reopened, ask_reason_invalid, ask_session_unknown, ask_unavailable, agent_pane_required, caller_context_changed.
Syntax from the command contract.
Project Memory
Section titled “Project Memory”hide memory show
Section titled “hide memory show”Prints one Project Memory card in full, with its status and where its words came from.
hide memory show <card> | search <words> | add <text> | forget <card> | undo <card> | placed <card> <path> | building <card> <branch> <path> | unbuilt <card> <reason> | outdated <card> <reason> | skipped <card> <reason> | stale <card> <reason> | release <card> | recheck <card>Example:
hide memory show m508Syntax from hide --help; not in the command contract.
hide memory search
Section titled “hide memory search”Finds Project Memory cards that match some words, and prints each card’s number and title.
hide memory show <card> | search <words> | add <text> | forget <card> | undo <card> | placed <card> <path> | building <card> <branch> <path> | unbuilt <card> <reason> | outdated <card> <reason> | skipped <card> <reason> | stale <card> <reason> | release <card> | recheck <card>Example:
hide memory search ProjectSyntax from hide --help; not in the command contract.
hide memory add
Section titled “hide memory add”Sends a decision the operator made to Project Memory, which writes it as a card that later agents can read.
hide memory show <card> | search <words> | add <text> | forget <card> | undo <card> | placed <card> <path> | building <card> <branch> <path> | unbuilt <card> <reason> | outdated <card> <reason> | skipped <card> <reason> | stale <card> <reason> | release <card> | recheck <card>Example:
hide memory add 'Use the staging database for migration tests.'Syntax from hide --help; not in the command contract.
hide memory forget
Section titled “hide memory forget”Takes a Project Memory card out of use, when the operator asks for it; memory undo brings it back.
hide memory show <card> | search <words> | add <text> | forget <card> | undo <card> | placed <card> <path> | building <card> <branch> <path> | unbuilt <card> <reason> | outdated <card> <reason> | skipped <card> <reason> | stale <card> <reason> | release <card> | recheck <card>Example:
hide memory forget m508Syntax from hide --help; not in the command contract.
hide memory undo
Section titled “hide memory undo”Brings back a Project Memory card that was taken out of use.
hide memory show <card> | search <words> | add <text> | forget <card> | undo <card> | placed <card> <path> | building <card> <branch> <path> | unbuilt <card> <reason> | outdated <card> <reason> | skipped <card> <reason> | stale <card> <reason> | release <card> | recheck <card>Example:
hide memory undo m508Syntax from hide --help; not in the command contract.
hide memory placed
Section titled “hide memory placed”Records that a Project Memory card has been written into a document at a path, for the agent that moves cards into documents.
hide memory show <card> | search <words> | add <text> | forget <card> | undo <card> | placed <card> <path> | building <card> <branch> <path> | unbuilt <card> <reason> | outdated <card> <reason> | skipped <card> <reason> | stale <card> <reason> | release <card> | recheck <card>Syntax from hide --help; not in the command contract.
hide memory building
Section titled “hide memory building”Records the branch that implements a Project Memory card’s decision and the file there that already documents it, for the agent that moves cards into documents.
hide memory show <card> | search <words> | add <text> | forget <card> | undo <card> | placed <card> <path> | building <card> <branch> <path> | unbuilt <card> <reason> | outdated <card> <reason> | skipped <card> <reason> | stale <card> <reason> | release <card> | recheck <card>Syntax from hide --help; not in the command contract.
hide memory unbuilt
Section titled “hide memory unbuilt”Records why a Project Memory card cannot be written into a document yet, for the agent that moves cards into documents.
hide memory show <card> | search <words> | add <text> | forget <card> | undo <card> | placed <card> <path> | building <card> <branch> <path> | unbuilt <card> <reason> | outdated <card> <reason> | skipped <card> <reason> | stale <card> <reason> | release <card> | recheck <card>Syntax from hide --help; not in the command contract.
hide memory outdated
Section titled “hide memory outdated”Records why a Project Memory card is outdated and marks it for another check, for the agent that moves cards into documents.
hide memory show <card> | search <words> | add <text> | forget <card> | undo <card> | placed <card> <path> | building <card> <branch> <path> | unbuilt <card> <reason> | outdated <card> <reason> | skipped <card> <reason> | stale <card> <reason> | release <card> | recheck <card>Syntax from hide --help; not in the command contract.
hide memory skipped
Section titled “hide memory skipped”Records why a Project Memory card was skipped when moving cards into documents.
hide memory show <card> | search <words> | add <text> | forget <card> | undo <card> | placed <card> <path> | building <card> <branch> <path> | unbuilt <card> <reason> | outdated <card> <reason> | skipped <card> <reason> | stale <card> <reason> | release <card> | recheck <card>Syntax from hide --help; not in the command contract.
hide memory stale
Section titled “hide memory stale”Reports that a Project Memory card no longer matches what the operator said, so Hide holds it back from agents until the session is analyzed, the hold is released or its time runs out; a hold is only accepted for a card whose full text this session’s prompt gave the agent, not for one it only looked up with memory show or saw in the starting list.
hide memory show <card> | search <words> | add <text> | forget <card> | undo <card> | placed <card> <path> | building <card> <branch> <path> | unbuilt <card> <reason> | outdated <card> <reason> | skipped <card> <reason> | stale <card> <reason> | release <card> | recheck <card>Example:
hide memory stale m508 'The operator moved the issue template.'Syntax from hide --help; not in the command contract.
hide memory release
Section titled “hide memory release”Ends a hold that an agent’s stale report put on a card, so agents get the card again.
hide memory show <card> | search <words> | add <text> | forget <card> | undo <card> | placed <card> <path> | building <card> <branch> <path> | unbuilt <card> <reason> | outdated <card> <reason> | skipped <card> <reason> | stale <card> <reason> | release <card> | recheck <card>Example:
hide memory release m508Syntax from hide --help; not in the command contract.
hide memory recheck
Section titled “hide memory recheck”Asks for a Project Memory card to be checked again, and keeps it out of agents’ prompts until that check ends; it needs Hide AI on, and an agent may ask only for a card its prompt gave it (the starting list counts, memory show alone does not).
hide memory show <card> | search <words> | add <text> | forget <card> | undo <card> | placed <card> <path> | building <card> <branch> <path> | unbuilt <card> <reason> | outdated <card> <reason> | skipped <card> <reason> | stale <card> <reason> | release <card> | recheck <card>Example:
hide memory recheck m508Syntax from hide --help; not in the command contract.