Skip to content

feat(workflows): add an explore-panopticon shell workflow#322

Open
tildesrc wants to merge 3 commits into
mainfrom
panopticon/explore-panopticon-workflow
Open

feat(workflows): add an explore-panopticon shell workflow#322
tildesrc wants to merge 3 commits into
mainfrom
panopticon/explore-panopticon-workflow

Conversation

@tildesrc

Copy link
Copy Markdown
Contributor

Adds explore-panopticon, a runner_type = "shell" workflow (no container) that opens a throwaway clone of panopticon plus an interactive claude to help the operator understand and navigate the codebase.

What it does

  • Clones panopticon into a self-cleaning temp dir (mktemp -d + an EXIT trap that rm -rfs it), so nothing is left behind however the session ends.
  • Pins the clone to the version the operator is running: it clones the public remote and checks out the v<version> tag (resolved from panopticon.__version__), falling back to the default branch when there's no matching tag.
  • Starts a plain interactive claude in the clone with an appended system prompt framing it as a read-only guide — pointed at AGENTS.md, docs/design/, and the module map — to answer the operator's questions. No changes, no MCP wiring.
  • On quitting claude, the temp clone is removed and the task advances to COMPLETE via the panopticon shell lib.

How it's launched

Like setup-repo, it's hidden from both pickers and launched from the repos modal — a new p hotkey creates the task on the highlighted repo. The repo only supplies the task's repo_id and the host shell's claude credentials (its env-file); the clone is always panopticon.

Notes

  • Mirrors the existing setup-repo shell-workflow structure (.py + sibling .sh shipped in the wheel, ShellRunner, task_lib.sh).
  • Stays LLM-free control plane: the only LLM call is the operator's own interactive claude, spawned by the host shell — the determinism invariant holds.
  • No schema/migration changes.

🤖 Generated with Claude Code

panopticon-agent and others added 3 commits July 14, 2026 21:04
A new `runner_type = "shell"` workflow (no container) that clones panopticon
into a self-cleaning temp dir and opens an interactive `claude` in it, framed as
a read-only guide to help the operator understand and navigate the codebase.

The clone is pinned to the version the operator is running: it clones the public
remote and checks out the `v<version>` tag (falling back to the default branch
when there's no matching tag). A `mktemp -d` dir removed by an EXIT trap gives
the "automatically cleaned up" temporary directory; on quitting `claude` the
script advances the task to COMPLETE via the panopticon shell lib.

Like `setup-repo`, it's hidden from the pickers and launched from the repos
modal — a new `p` hotkey creates the task on the highlighted repo (which only
supplies the host shell's `claude` credentials; the clone is always panopticon).

Stays LLM-free control plane: the only LLM call is the operator's own
interactive `claude`, spawned by the host shell.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
…task

Adds a direct top-level launch for the guided-tour workflow alongside the repos
modal's `p`: `e` picks a repo (skipping the picker when there's only one) and
creates an explore-panopticon task on it. The repo only supplies the task and the
host shell's `claude` credentials; the clone is always panopticon.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
… shortcut

The spawn hotkey is only a testing convenience, not a user-facing feature, so
consolidate the earlier top-level `e` and repos-modal `p` launches into a single
low-profile `E` binding on the workflow picker. Pressed there, it spawns the
hidden explore-panopticon workflow on the repo already chosen for the new task,
without it needing to be a menu entry.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant