skein_watchers
The caller's own notification subscriptions, at three scopes: one issue, a whole project, or a saved filter (custom watcher). Automatic subscriptions: the assignee of an issue (except one filled in at create by the "assign agent-created issues to me" setting); its creator (the human who owns the API key) only for issues created by hand or as a TOP-LEVEL agent_directed issue — an issue your agent files under a parent, or with source=agent_autonomous, does not subscribe you. Unsubscribing from an issue you watch records an opt-out: the auto-watch paths (creator, assignee, reopen) will not re-subscribe you to that issue until you watch it again with action="watch", and the issue's card leaves your Watching column. Per-user cap: 10 filter watchers. Also stops one of your task monitors (action="monitor_stop", by the monitorId skein_get_monitor_script returned). Read-only actions: list, filter_list.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"action": "<action>"
},
"name": "skein_watchers"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Filter-watcher name, unique per user, 100 chars max. Required for filter_create. | |
| action | Yes | What to do: - "watch" → subscribe to one issue (reason='manual'; removes your opt-out from an earlier unwatch). - "unwatch" → unsubscribe from one issue: the subscription is deleted, an opt-out stops automatic re-subscription, the issue's Watching card is cleared. Not subscribed → only the card is removed, no opt-out. - "project_watch" → subscribe to a whole project's notifiable events. - "project_unwatch" → unsubscribe from a project. - "filter_create" → create a saved-filter watcher from `name` + `filter`. - "filter_delete" → remove one filter watcher by `filterId`. - "filter_list" → list the caller's filter watchers. - "list" → the caller's full subscription state: issues, projects and filters at once. - "monitor_stop" → stop one of your task monitors by `monitorId`: its token is revoked, its runner ends with token_expired on its next poll, other monitors (same issue included) keep running. Works from any of your API keys; stopping an already stopped monitor succeeds; another user's or an unknown id → monitor_not_found. | |
| filter | No | Filter-watcher matching rules. Required for filter_create. All fields optional, an omitted field means "no constraint": event_types[] | projects[] | types[] | labels[] | components[] | priority_max. | |
| issueId | No | Full hierarchical issue id, e.g. "demo-42" or "demo-42.1". Required for watch and unwatch. | |
| project | No | Project handle: alias, name, or UUID. Required for project_watch and project_unwatch. | |
| subtree | No | Only read by watch. When true, subscribe to this issue AND its subtree by the hierarchy: every issue that has it as a parent, grandparent, … at the moment of each event (parentIdCurrent chain — not an id prefix); future subtasks are covered automatically. subtree dominates: it upgrades an existing plain watch and a later subtree=false watch never downgrades it. Default: false (this issue only). | |
| filterId | No | Filter-watcher UUID, as returned by filter_create or filter_list. Required for filter_delete. | |
| monitorId | No | Monitor id (UUID) as returned by skein_get_monitor_script. Required for monitor_stop. | |
| eventTypes | No | Only read by project_watch: whitelist of event types to subscribe to (e.g. ["issue.created", "comment.created"]). Each value must be a notifiable event type. Omit to leave the existing whitelist alone (or receive every notifiable type on a first subscribe); pass an empty array to clear it back to "all". |