zig-core 0.5.6

Core library for zig — workflow orchestration engine for AI coding agents
Documentation 
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
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72

# zig

Orchestration CLI for AI coding agents — describe, share, and run workflows powered by zag.

## Synopsis

```
zig <command> [options]
```

## Description

`zig` lets you describe a workflow in natural language, capture it as a
shareable `.zug` file, and replay it anywhere with a single command. It uses
zag behind the scenes for agent orchestration.

## Commands

| Command              | Description                                              |
|----------------------|----------------------------------------------------------|
| `run <workflow>`     | Execute a `.zug` workflow file                           |
| `listen [session]`   | Tail a running or completed zig session                  |
| `workflow <command>` | Manage workflows (list, show, create, delete, pack)      |
| `describe <prompt>`  | Generate a `.zug` file from a natural language prompt    |
| `validate <file>`    | Validate a `.zug` workflow file                          |
| `init`               | Initialize a new zig project                             |
| `man [topic]`        | Show manual pages for zig topics                         |

## Global Flags

| Flag        | Short | Description                        |
|-------------|-------|------------------------------------|
| `--debug`   | `-d`  | Enable debug logging               |
| `--quiet`   | `-q`  | Suppress all output except errors  |
| `--version` |       | Print version information          |
| `--help`    | `-h`  | Print help                         |

## Getting Started

```bash
# Create a workflow interactively
zig workflow create my-workflow

# Or describe one in natural language
zig describe "review code, run tests, and generate a report"

# Run a workflow
zig run my-workflow

# Validate a workflow file
zig validate my-workflow.zug
```

## Manpages

Use `zig man` to learn more about specific topics:

```bash
zig man run          # The run command
zig man listen       # Tail a running or completed zig session
zig man workflow     # Manage workflows (list, show, create, delete, pack)
zig man zug          # The .zug file format
zig man patterns     # Orchestration patterns
zig man variables    # Variable system and data flow
zig man conditions   # Condition expressions
```

## See Also

- `zig man zug` — the `.zug` workflow format
- `zig man patterns` — orchestration patterns
- zag documentation: https://github.com/niclaslindstedt/zag