Reference · Information

`senkani_watch`

Live

Query recently-changed files via an FSEvents ring buffer, filtered by cursor + glob.

Signature

senkani_mcp.call(tool="senkani_watch", args={...})

Behavior

500-entry ring buffer on `MCPSession`. Query by timestamp cursor + glob pattern; returns changed file paths since last check. Zero polling cost — the buffer fills from FSEvents in the background.

Inputs

Name

Type

Default

Description

since

string

"session_start"

Cursor — ISO timestamp or `session_start`.

glob

string

"**/*"

Filter by path.

limit

integer

100

Max entries.

Output

List of `{{path, kind, timestamp}}`. Advances cursor in the response so the next call picks up exactly where this left off.

Example

{"tool":"senkani_watch","args":{"glob":"src/**/*.ts"}}

Details

Ring buffer drops oldest on overflow — for long sessions, poll more often or widen the limit.

senkani_watch