claude

tsk

Missions, threads and the ledger for Claude Code sessions, backed by the tsk binary

3 on GitHubby Jim Barrittv0.3.45MITupdated 8 days ago
/

Plugin tsk from marketplace jimbarritt-claude-plugins in jimbarritt/claude-plugins. Commands read from the repo's manifest — 7 days ago.

This plugin runs code on your machine — its hooks fire automatically on events like tool use. The exact commands are listed below; read them before installing.

What it installs

Skills (12)

  • construct-robot

    Construct a new robot. The robot chooses a name of its own in the style of the Culture ships of Iain M. Banks, registers it as a tsk actor, and sets its session title to the name. Invoke explicitly as /tsk:construct-robot, or when asked to name this session or to construct a robot.

  • detach-thread

    Remove this session or code worktree's binding from its current tsk thread, without deleting the thread. Invoke explicitly as /tsk:detach-thread.

  • pause-thread

    Record a continuation state entry for the current thread before ending the session, so a later /tsk:resume-thread (by this actor or another) can pick the work back up. Invoke explicitly as /tsk:pause-thread, always run by the human themselves before /clear.

  • regenerate-cloud-instance

    Replace this cloud session with a new one that attaches to the same thread and reuses the robot name, then mark this session for archive. Invoke explicitly as /tsk:regenerate-cloud-instance, or when asked to regenerate this cloud session.

  • register-repo

    Add this repo's entry to the attached nexus's nexus.json, then commit and push it, so the repo's ledger can live in the nexus. Invoke explicitly as /tsk:register-repo [<id>] [<territory>], or when a natural-language request asks to register this repo in the nexus.

  • resume-thread

    Load a tsk thread's latest continuation state entry and pick the work back up, as the thread's original actor after a session boundary, or as a different actor taking over. Invoke as /tsk:resume-thread <thread-id>, or automatically when the SessionStart hook finds an existing binding.

  • self-update

    Update the tsk binary to the latest release and report the old and new version. Invoke explicitly as /tsk:self-update, or when asked to update tsk.

  • start-thread

    Create a tsk thread for a harness instance that has no bound thread and no thread to join, for a named mission or with no mission. Invoke explicitly as /tsk:start-thread [<mission>], or from /tsk:switch-mission when nothing is bound. To change the mission of a bound thread, use /tsk:switch-mission.

  • stop-thread

    Detach this session or code worktree from its current tsk thread, then delete the thread entirely, including its directory, continuation state, and every binding to it. Invoke explicitly as /tsk:stop-thread. Destructive.

  • switch-mission

    Change the current focus of the tsk thread this session is bound to, to another mission. Pauses the thread on its current focus, sets the new mission, and sets the session title. Invoke as /tsk:switch-mission <mission>, or when a request names a mission to work on and this session is bound to a thre

  • switch-thread

    Move this session from its current tsk thread to a different thread, a different line of work, named explicitly or chosen from a list. The thread left behind stays for its actor to resume. To change the mission of the same line of work, use /tsk:switch-mission. Invoke as /tsk:switch-thread [<thread-

  • tsk

    Reference for the tsk command line: the ledger, threads and bindings, continuation state, and the external event queue. Load when working with tsk missions, threads or the ledger, or when a tsk command is needed.

Hooks (9)

  • PreToolUse

    "${CLAUDE_PLUGIN_ROOT}/hooks/pre-tool-use.sh"

  • SessionStart

    "${CLAUDE_PLUGIN_ROOT}/hooks/session-start.sh"

  • Stop

    "${CLAUDE_PLUGIN_ROOT}/hooks/stop.sh"

  • Stop

    "${CLAUDE_PLUGIN_ROOT}/hooks/tmux-state.sh" waiting

  • SessionEnd

    "${CLAUDE_PLUGIN_ROOT}/hooks/session-end.sh"

  • SessionEnd

    "${CLAUDE_PLUGIN_ROOT}/hooks/tmux-state.sh" none

  • UserPromptSubmit

    "${CLAUDE_PLUGIN_ROOT}/hooks/tmux-state.sh" working

  • PostToolUse

    "${CLAUDE_PLUGIN_ROOT}/hooks/tmux-state.sh" working

  • Notification

    "${CLAUDE_PLUGIN_ROOT}/hooks/tmux-state.sh" waiting

View source on GitHub

More from jimbarritt/claude-plugins

All 2 plugins →

swe

claude

Checks agent prose against Software English via three hooks, a selectable output style, on-demand check commands, and a git commit check.

5 skills · hooks

3

Maintain tsk?

This page updates itself from your repo. Add the badge to your README, or get it Featured to pin it above the organic results with a followed link to your site.

claude & codex plugins2 plugins