# Command line

Every `noodlelab` command, with its options, from `noodlelab <command> --help`.

## `noodlelab serve`

Start the editor, API and admin portal.

```text
usage: noodlelab serve [-h] [--host HOST] [--port PORT] [--home HOME]
                       [--auth {none,users}] [--no-browser] [--demo]
                       [folder]

positional arguments:
  folder               open this folder as a workspace

options:
  -h, --help           show this help message and exit
  --host HOST          default 127.0.0.1
  --port PORT          default 8000
  --home HOME          server state, default ~/.noodlelab
  --auth {none,users}  default: none on localhost, users otherwise
  --no-browser
  --demo               public demo: no login, no admin, files confined to the
                       workspace (NOODLELAB_DEMO=1)
```

## `noodlelab run`

Run a saved graph without the editor.

```text
usage: noodlelab run [-h] [--target TARGET] [--workspace WORKSPACE]
                     [--home HOME] [--no-checkpoints] [--no-provenance] [-v]
                     [--run-id RUN_ID] [--events EVENTS]
                     [--cancel-file CANCEL_FILE] [--info INFO]
                     graph

positional arguments:
  graph

options:
  -h, --help            show this help message and exit
  --target TARGET       only run what this node id needs
  --workspace WORKSPACE
  --home HOME
  --no-checkpoints      compute everything
  --no-provenance       do not write provenance.json
  -v, --verbose
  --run-id RUN_ID       the run's id (default: a new one)
  --events EVENTS       append the run's events to this file (JSONL)
  --cancel-file CANCEL_FILE
                        stop between nodes once this file exists
  --info INFO           JSON added to the run's provenance, e.g. who ran it
```

## `noodlelab test`

Run graphs as tests: checks and baselines, for CI.

```text
usage: noodlelab test [-h] [--baseline BASELINE] [--rtol RTOL] [--atol ATOL]
                      [--junit JUNIT] [--workspace WORKSPACE] [--home HOME]
                      [--no-checkpoints]
                      graphs [graphs ...]

positional arguments:
  graphs

options:
  -h, --help            show this help message and exit
  --baseline BASELINE   compare with a run: 'final' (the newest run of the
                        graph marked final) or a run folder name
  --rtol RTOL           relative tolerance (1e-9)
  --atol ATOL           absolute tolerance (0)
  --junit JUNIT         write a JUnit XML report
  --workspace WORKSPACE
  --home HOME
  --no-checkpoints      compute everything
```

## `noodlelab verify`

Run scripts or graphs and audit them: checks, requirements, units, provenance.

```text
usage: noodlelab verify [-h] [--json] [--strict] [--arg ARGS]
                        [--workspace WORKSPACE] [--home HOME]
                        [--no-checkpoints]
                        targets [targets ...]

Run Python scripts that use noodlelab.verify.record() and graphs
(.graph.json), or read records written earlier (provenance.json or a folder),
and audit them. Exit code 0 when all pass, 1 when a check fails or is
inconclusive or a requirement was not verified, 2 when a target could not run.

positional arguments:
  targets               script.py, graph.json or records

options:
  -h, --help            show this help message and exit
  --json                machine-readable output
  --strict              warnings fail too
  --arg ARGS            script argument
  --workspace WORKSPACE
  --home HOME
  --no-checkpoints      compute everything
```

## `noodlelab mcp`

MCP server for AI agents (stdio): build, run and verify graphs and reports.

```text
usage: noodlelab mcp [-h] [--workspace WORKSPACE] [--home HOME]

A Model Context Protocol server on stdin/stdout. Add it to Claude Code with
`claude mcp add noodlelab -- noodlelab mcp`, to Codex CLI with `codex mcp add
noodlelab -- noodlelab mcp`, or run `noodlelab init-agent` in a project.

options:
  -h, --help            show this help message and exit
  --workspace WORKSPACE
                        default: this folder
  --home HOME
```

## `noodlelab init-agent`

Set up a project for AI agents: AGENTS.md, CLAUDE.md, skill and .mcp.json.

```text
usage: noodlelab init-agent [-h] [--command COMMAND_LINE] [--no-claude]
                            [folder]

positional arguments:
  folder

options:
  -h, --help            show this help message and exit
  --command COMMAND_LINE
                        how agents start the server, quoted as in a shell
                        (default: noodlelab mcp)
  --no-claude           skip CLAUDE.md and the skill
```

## `noodlelab nodes`

List installed nodes.

```text
usage: noodlelab nodes [-h] [--json] [--strict]

options:
  -h, --help  show this help message and exit
  --json
  --strict    apply strict typing rules
```

## `noodlelab constants`

List the named constants: built-in, the workspace's constants.toml, a graph's own.

```text
usage: noodlelab constants [-h] [--workspace WORKSPACE] [--json] [graph]

positional arguments:
  graph                 include this graph's constants

options:
  -h, --help            show this help message and exit
  --workspace WORKSPACE
                        workspace root (default: cwd)
  --json
```

## `noodlelab tiers`

Show the installed tier and how to add others.

```text
usage: noodlelab tiers [-h] [--json]

options:
  -h, --help  show this help message and exit
  --json
```

## `noodlelab export`

Export a graph as a Python script.

```text
usage: noodlelab export [-h] [-o OUTPUT] [--workspace WORKSPACE] graph

positional arguments:
  graph

options:
  -h, --help            show this help message and exit
  -o OUTPUT, --output OUTPUT
  --workspace WORKSPACE
                        where the graph's file paths start
```

## `noodlelab new-pack`

Scaffold a new node pack.

```text
usage: noodlelab new-pack [-h] [--directory DIRECTORY] name

positional arguments:
  name                  e.g. 'spectroscopy'

options:
  -h, --help            show this help message and exit
  --directory DIRECTORY
```

## `noodlelab check-pack`

Lint a node pack module.

```text
usage: noodlelab check-pack [-h] [--pack PACK] module

positional arguments:
  module       importable module, e.g. my_pack.nodes

options:
  -h, --help   show this help message and exit
  --pack PACK  id prefix, default: top-level module
```

## `noodlelab admin-token`

Print a new admin token.

```text
usage: noodlelab admin-token [-h] [--home HOME]

options:
  -h, --help   show this help message and exit
  --home HOME
```