zag-cli 0.12.0

A unified CLI for AI coding agents — Claude, Codex, Gemini, Copilot, and Ollama
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52

# zag status

Machine-readable session health check.

## Synopsis

    zag status <session-id> [--json] [--root <path>]

## Description

Reports the current status of a session by combining information from the session store, process store, and session log. Designed for orchestration scripts that need to poll session health.

## Arguments

    session-id    Session ID (full or prefix match)

## Flags

    --json               Output as JSON
    -r, --root <PATH>    Root directory for session resolution

## Status Values

    running      Process alive, log activity within last 30 seconds
    idle         Process alive, no log activity for 30+ seconds
    completed    Session ended successfully (SessionEnded with success=true)
    failed       Session ended with failure (SessionEnded with success=false)
    dead         Process died without a clean SessionEnded event
    unknown      Session exists in store but no process or log found

## JSON Output

    {"session_id":"...","status":"running","provider":"claude","model":"sonnet","name":"my-agent","pid":12345}

Fields `name`, `pid`, and `error` are omitted when null.

## Exit Codes

    0    Status retrieved successfully
    1    Session not found or error

## Examples

    zag status $sid                     Check session status (text)
    zag status $sid --json              JSON output
    zag status $sid --json | jq .status Extract just the status string

## See Also

    zag man wait      Block until sessions complete
    zag man ps        Process management
    zag man listen    Real-time session log tailing