AgentKit
ReferenceCLI commands
BetaYou are reading docs for the beta channel (2.4.1-beta.1) — updated automatically on every beta release.Switch to stable →

CLI commands

ak watch stop

Stop a running watch daemon for the given repository

Mark a repository watch as inactive by updating the state file. The next daemon poll cycle detects the inactive flag and stops automatically. Safe to call even when no daemon is running - exits 0 with an informational message.

Who it's for: Both: power devs deactivating automated triage workflows and non-technical users.

When to use it: When you want to stop a watch daemon started with ak watch start --daemon, or deactivate a repository from automated triage.

What changes on disk: Writes active=false to ~/.agentkit/watch/<repo-slug>/state.json.

Usage

ak watch stop <owner/repo> [flags]

Examples

ak watch stop owner/repo          # stop watching a repository
ak watch stop owner/repo --json   # emit confirmation as JSON

Flags

FlagDescription
-h, --helphelp for stop
--jsonEmit machine-readable JSON (implies --no-interactive)
--no-interactiveDisable interactive prompts (CI-safe)
-q, --quietSuppress non-error output on stderr
-V, --verboseExtra diagnostic output on stderr (loses to --quiet)
-y, --yesAssume yes for all prompts

Output modes

ModeBehavior
prettydefault on TTY (colors, ASCII markers)
plainauto when stdout piped or --no-interactive
json--json (single-object envelope, NDJSON-safe)

Exit codes

CodeMeaning
0success
1runtime error
2invalid flags
3user-cancel (SIGINT, prompt-cancel)
  • ak watch — Watch a GitHub repository and auto-respond to issues

On this page