threadbear

name	threadbear
description	Install, update, check, or uninstall ThreadBear for Codex Desktop on macOS.

ThreadBear

Be upbeat and plain.

• Before consent, end with Here's what will happen: changes, untouched items, restart, one question.
• After tools, end with ThreadBear recap 🐻: result, uncertainty, next action.

Put the recap in the final answer. Call safe skips “left unchanged.” Give partials one action.

Install or reset

Follow https://threadbear.sh/install. Preview the helper, instructions, skill, daily updates, and the one ephemeral existing-task first read. Titles do not change before installation succeeds. After the friendly installed recap, Codex asks once for the complete-catalog read; declining leaves existing titles untouched. If allowed, the first read uses the guide's single yielded cell: its local helper only classifies, while mounted Codex rereads and serially applies exact or ✦ best-guess icons. Unknown tasks stay untouched. Never replace that cell with a controller, task, queue, retry pass, or other writer.

For 2.2.1, touch only the verified old task and automation; stop on mismatch.

After consent, install; verify version, self-test, status. Recap:

ThreadBear is installed. Codex will ask once for the complete-catalog read. If allowed, existing tasks with clear enough history will gain icons over the next several minutes; a small sparkle marks a first read and disappears on that task's next turn. Declining or unclear evidence leaves a task untouched. Keep working, and restart Codex when ready.

Uninstall

1. Say: “Codex will ask once so ThreadBear can read the complete task list. This preview changes nothing.” Run uninstall --dry-run --json with sandbox_permissions:"require_escalated". Require ready:true, plan_complete:true, read_only:true. Preview removing one ThreadBear prefix from each safe unarchived task, then the helper, instructions, skill, and updates. Tasks, settings, files, user-authored titles, ambiguous prefixes, unsafe titles, and archived tasks stay unchanged. Ask consent.
2. If Codex says approval requests are disabled, stop. Never change settings or bypass permission.
3. After consent, run this exact cell once:

// @exec: {"yield_time_ms": 30000, "max_output_tokens": 4000}
const runCLI = async (cmd, justification) => {
  let call = await tools.exec_command({cmd,yield_time_ms:30000,max_output_tokens:200000,
    sandbox_permissions:"require_escalated",justification});
  let output = call.output || "";
  while (call.session_id !== undefined) {
    call = await tools.write_stdin({session_id:call.session_id,yield_time_ms:30000,
      max_output_tokens:200000});
    output += call.output || "";
  }
  return {call,output};
};
notify("ThreadBear uninstall: preparing title cleanup");
const preparedCall = await runCLI(
  "\"$HOME/.local/bin/threadbear\" uninstall --prepare --noninteractive --confirm --json",
  "Allow ThreadBear to read the complete Codex task list for the uninstall you approved?"
);
if (preparedCall.call.exit_code !== 0) { text(preparedCall.call); exit(); }
let plan;
try { plan = .(preparedCall.); }
 { (.({:,:})); (); }
 (!plan || plan. !==  || plan. !==  ||
    plan. !==  || !.(plan.) ||
    !.(plan.) || !.(plan.) ||
    !.(plan.) || !.(plan.) ||
    plan. !== plan. ||
    !.(plan.)) {
  (.({:,:})); ();
}
 prepared = plan..( item. === );
 (prepared. !== plan. || prepared.( !item ||  item. !==  ||
     item. !==  ||  item. !== )) {
  (.({:,:})); ();
}
 updated = , drifted = , unconfirmed = ;
  = value => {
   ( value !== )  value;
   {  .(value); }  {  ; }
};
 ( item  prepared) {
   current;
   {
    current = ( tools.({:item.,
      :,:,:}));
  }  { current = ; }
   (current?.?. !== item. || current.. !== item.) drifted++;
   {
     renamed;
     {
      renamed = ( tools.({:item.,
        :item.}));
    }  { renamed = ; }
     (renamed &&  renamed ===  && renamed. === item. &&
        renamed. === item.) updated++;
     unconfirmed++;
  }
   done = updated + drifted + unconfirmed;
   (done %  ===  || done === prepared.) ();
}
 accounted = updated + drifted + unconfirmed === prepared.;
 (!accounted || drifted !==  || unconfirmed !== ) {
  (.({:,:,:,
    :,:plan.,:plan.,updated,drifted,
    :plan.,:plan.,unconfirmed,
    :}));
  ();
}
();
 removedCall =  (
  ,
  
);
 removed;
 { removed = .(removedCall.); }
 { (.({:,:,:,
  :{:plan.,updated,:plan.,:plan.}})); (); }
removed. = {:plan.,updated,:plan.,:plan.};
(.(removed));

Only uninstalled:true means removed. Otherwise recap the partial and its one next action. Never retry a drifted or unconfirmed title in the same pass. After artifact commit, make no title call. Successful recap: “ThreadBear was removed. X task titles were cleaned; Y were left unchanged. Its helper, instructions, skill, and automatic updates are gone. Tasks, settings, and files stayed. Restart Codex.”

Update

Preview download, checks, replacement, and restart. With consent run update --json; recap version and next action.