How-to guides

Task-oriented recipes. Each guide assumes you already have lazybox running (see the Quickstart) and walks one real goal to completion. Pick the one that matches what you need to do.

• Use snippet workflows — turn recurring agent instructions into fast, reusable workflows with recent-first and per-workspace memory.
• Add a repo — bring a repository’s PRs and issues into the inbox, and filter by your role.
• Run an agent per workspace — use w w and GitHub priorities to route task context, the target agent, model, and reasoning effort into one isolated worktree.
• Keep your issue session in its PR — start an agent before the PR exists, then carry its live terminal, worktree, and context into the closing PR.
• Orchestrate multiple agents — multi-select, broadcast one instruction to many workspaces, bulk-update branches, and hand work from one agent to another.
• Manage automation policies — inspect and toggle merge-on-green and per-workspace auto-fix behavior from the unified g p menu.
• Trigger agents with @lazybox mentions — choose priority and start an agent entirely from a GitHub issue, or tag a whole backlog of issues you authored or are assigned to with a lazybox: label to start a fleet across repos.
• Get desktop notifications — fire an OS banner when an agent needs input, including over SSH.
• Change the theme — live-preview and persist a color palette.
• Per-repo env and mounts — inject environment variables, symlink shared directories, and materialize scripts into worktrees.
• Connect Linear — bring your Linear issues into the inbox alongside GitHub.
• Remote over SSH — run the daemon on one machine and the TUI on another over a forwarded Unix socket.
• Mirror to Slack — reflect your inbox into Slack channels.
• Recover persistent state — preserve and diagnose an unreadable database without deleting worktrees.