ReferenceCLI reference
CLI reference
Every `noodle` command, generated from the CLI's command catalog.
The noodle CLI authors, validates, runs, deploys, and operates Noodle Seed servers. Install it with:
npm install -g @noodleseed/one| Command | Description |
|---|---|
noodle help | Print CLI usage and per-command help. |
noodle version | Print the installed CLI version. |
noodle commands | Print the machine-readable command catalog, or a compact human list. |
noodle features | Show the public Claude, ChatGPT, and embedded-host compatibility registry. |
noodle start | Guided first-run: sign in, scaffold, then deploy or run locally. |
noodle init | Create a local Noodle project from a template. |
noodle setup | Reconcile project config and local coding-agent files. |
noodle link | Bind this directory to a Noodle Seed Cloud deploy target (org/app/env). |
noodle doctor | Check login, service, project, validation, and config. |
noodle agents | Generate or refresh project-local Codex and Claude Code files. |
noodle auth | Diagnose customer OIDC/provider and delegated-credential readiness. |
noodle docs | Export the docs for LLM and coding-agent consumption. |
noodle connect | Print connection setup for an MCP client host. |
noodle import | Scaffold starter code from an OpenAPI spec. |
noodle export | Compile locally and write the portable manifest JSON (no service — the eject path). |
noodle validate | Author-time compile check (schema, expressions, connector refs); no service. |
noodle check | Check MCP Apps/widget readiness; no service. |
noodle test | Local compile plus a loopback MCP smoke. |
noodle tools | List or call local tools via a loopback MCP smoke. |
noodle resources | Read local resources via a loopback MCP smoke. |
noodle prompts | Get local prompts via a loopback MCP smoke. |
noodle dev | Run a local runtime, serve + hot-reload the manifest, and exercise tools (no account/login). |
noodle devtools | Three-pane widget preview: tool list, live in-iframe render, MCP call log. |
noodle update | Check for, install, or safely repair the global CLI install. |
noodle billing | Inspect billing accounts, entitlements, metering, and enforcement classification. |
noodle assistant | Configure and validate the customer-branded embedded assistant boundary. |
noodle audit | Operator governance audit status and event queries. |
noodle logs | Tenant-safe app logs (redacted, newest-first). |
noodle metrics | MCP analytics: volume, sessions, latency percentiles, errors, tools, clients for a deployed server. |
noodle events | The MCP request stream; --session replays one session in order. |
noodle alerts | Analytics alert rules: POST a webhook when error share, error count, calls, or p95 latency breaches. |
noodle policy | Manage policy admission: status/list/show/effective/simulate/suspend/resume/deny/quota/rate/usage/apply/delete/plan. |
noodle deploy | Compile and deploy your server to a governed, identity-gated MCP URL. |
noodle open | Open or print the latest linked deployment URL. |
noodle status | Show hosted deployment status. |
noodle inspect | Inspect hosted deployment metadata without secret material. |
noodle smoke | Run hosted readiness diagnostics and print external smoke commands. |
noodle rollback | Reactivate a historical deployment. |
noodle archive | Archive the whole app: endpoints answer 410 Gone; hard-deleted after the retention window. |
noodle restore | Restore an archived app within the retention window. |
noodle access | Set the identity access mode for a hosted deployment. |
noodle apps | List, inspect, or open hosted apps for an org. |
noodle envs | List or inspect environments for an app. |
noodle deployments | List or inspect individual deployments. |
noodle service | Query hosted service capabilities, scaffold a service config, or diagnose it. |
noodle login | Sign in to Noodle Seed Cloud. |
noodle logout | Sign out and clear saved credentials. |
noodle whoami | Show the signed-in identity. |
noodle orgs | List, create, rename, switch, or inspect organizations. |
noodle members | List, add, remove, or manage invitations for org members. |
noodle github | Connect, inspect, or disconnect the GitHub repository behind an app’s GitHub-native deploys. |
noodle target | Show or set the deploy target (runtime, service, org, app, env). |
noodle secrets | Manage secrets (set/list/delete/resolve), scoped to org/app/env. |
noodle variables | Manage non-secret variables (set/list/delete/resolve), scoped to org/app/env. |
This reference is generated from the CLI's command catalog. Run noodle <command> --help or
noodle commands --json for the latest details.