Report privately through GitHub's private vulnerability reporting on this repository. Please do not open a public issue for something exploitable. Expect a first response within a week; this is a solo-maintained project, not a funded security programme.
Four parts of drydock are worth understanding before you run it, and none is a vulnerability — they are what the tool does.
The board serves file contents from the STATE_HOME it is pointed at.
plugin/board/server.py binds 127.0.0.1 only, and exposes a fixed
allowlist of item files (SPEC.md, QUESTION.md, DELIVERABLE.md,
RUN.md, REJECTION.md, REPORT.md, REVIEW.md, READY.md) plus the
static frontend. There is no authentication, because there is no network
exposure to authenticate. Putting it behind a tunnel, a reverse proxy, or a
0.0.0.0 bind turns a local dashboard into an unauthenticated file server
for your queue — including whatever your specs and run logs happen to quote.
STATE_HOME (~/.drydock by default) is never given a git remote.
/drydock:install refuses to proceed if one is already configured there,
and every skill and contract that touches STATE_HOME treats a remote
appearing later as a hard stop. This is deliberate: STATE_HOME is where your
specs — which can quote internal systems, credentials-adjacent context, or
anything else your teammates shouldn't read — accumulate as git history.
Before this was a separate, remote-less directory, /drydock:install cloned
the drydock tool itself and the same clone doubled as the queue; a git push
from that clone, whether by habit or by the orchestrator's own housekeeping,
could have sent that history to whatever remote the clone happened to have —
including this project's own, if you'd also cloned it to contribute a fix.
Get durability without a remote via git bundle create <path> --all to
storage your own backup policy already covers.
The orchestrator dispatches agents that write to your repositories,
unattended. Executors run as background Claude Code sessions with
--permission-mode bypassPermissions, because a background session has nobody
to answer a permission prompt. That flag does not widen what drydock may do:
each executor is a separate Claude Code process that loads your
configuration — your settings.json permissions, your PreToolUse hooks,
your deny rules — and drydock never routes around them. Your permission
policy is the boundary. If you do not have a deny layer you trust, run
executors with --permission-mode acceptEdits instead and accept that some
runs stall on prompts. A stalled run is recoverable; an unreviewed mutation
against live infrastructure is not.
What follows from that: a specification is an instruction to an agent with
your credentials. Treat STATE_HOME/specs/inbox/ the way you would treat a
shell script someone handed you — reviewing a spec before it is dispatched is
the control, and it is why /drydock:spec writes specs rather than executing
them.
A spec's owner: line hands part of your role to another session. From
0.5.0 (0.4.0 and earlier do not read the line), a spec that names
owner: <session-name> sends its blocked, delivered, dispatch-failure and
budget events to whichever session ListAgents lists under that name, by
SendMessage, and lets that session decide the item's unblocks. Three things
follow:
- The name is an address, not an identity. The message goes to the session listed under that name when the event happens, and an owner may be a Remote Control, cloud or Claude Desktop session as well as one on this machine. Each message carries the item's id, a one-line gist of what happened and the item's absolute path in STATE_HOME, so an owner that is not on this machine is sent that text off it.
- The unblock takes a session's word that it is the owner, as it takes
yours at the keyboard, and
resolved_by:records what the deciding session wrote, not a verified identity. An owner that decides editsSPEC.md— requirements, criteria, budget, and nothing stops it changing the blast radius or the frontmatter in the same edit — and re-queues it, and the next executor runs the amended spec with your credentials before you have read it. The amendment is anunblock: <id>commit in STATE_HOME, the executor is still bounded by your permission policy, and the result still goes through the adversarial review before it ships. Approving a deliverable — for a pull request, marking the draft ready for your team — is not handed to the owner: no event asks it to, and/drydock:reviewis written for you. That is a convention, as the unblock's is; no skill checks who is running it. - Delivery is confirmed only where it can be. Anything short of a
confirmed delivery comes to you instead, except a message held or refused by
a Remote Control, cloud or Claude Desktop session, which reports nothing,
and a delivery notice that arrives after the tick that sent the message,
which no step handles: that event may reach no one, and the item waits on
the board. A confirmed delivery means the message reached the session, not
that anything acted on it. Run the owner on this machine, in the
orchestrator's permission mode — and note what that means when the loop
runs in
bypassPermissions: the owner session then runs without permission prompts too, bounded only by your permission policy.
Name as owner only a session you would let answer the question in your place.
Path traversal or allowlist escapes in plugin/board/server.py; anything
that lets the board serve a file outside the item directory it was asked
for; a contract path that would cause an executor to act outside a spec's
declared blast radius.
That the board has no authentication on 127.0.0.1. That executors run with
elevated permissions. That a specification can instruct an agent to do
something destructive — that is the adopter's permission policy and review
pass, described above.