Skip to content
june

June

·

Linear issues.
For agents.

June turns Linear issues into resumable local agent sessions. Comment to steer, stream progress back, and publish the runner’s stdout as the final Linear comment.

npx june@latest setup

How you use it

Section titled “How you use it”
  1. Run the setup wizard on an always-on Mac mini, Linux VPS, or dev box.
  2. Point a Linear webhook at June and choose the labels for Claude, Codex, OpenCode, Antigravity, Gemini, or Hermes.
  3. Open or comment on a Linear issue to start a runner session.
  4. Reply while the run is active to interrupt and steer it with new context.
  5. Review the final stdout comment when June moves the issue to Ready for Review or Blocked.

Note: June is self-hosted. Linear is the UI, your runner CLI stays logged in on your machine, and session state lives in local SQLite.

How agents use it

Section titled “How agents use it”

June gives each runner the context it needs without another dashboard:

  • the issue title, description, related links, and comment thread
  • the selected runner label and stored resumable session id
  • the working directory and configured progress-comment contract
  • deterministic exit handling for Ready for Review vs Blocked

Install

Section titled “Install”
Terminal window
npx june@latest setup

Node 22+ and a runner CLI already logged in are the only local prerequisites. The wizard asks for your Linear key, team, webhook URL, tunnel, and runner choices.

What you get

Section titled “What you get”
  • Per-issue sessions to keep each Linear thread mapped to one resumable runner context.
  • Bring your own runner so Claude Code, Codex, OpenCode, Antigravity, Gemini, and Hermes can all be selected by label.
  • Progress comments for short in-flight status without confusing them with the final deliverable.
  • Honest state transitions for success, timeout, interruption, and blocked work.

Resources

Section titled “Resources”
Setup Linear API key → webhook ingress → first agent run, end-to-end.
Concepts Sessions, steering, debounce, progress comments, the state machine.
Runners Claude Code, Codex, OpenCode, Antigravity, Hermes — which to use when.
Configuration Every env var, grouped by what it tunes. The Ctrl-F page.

License

Section titled “License”

MIT. Source is on GitHub. Issues and PRs welcome.