{
  "id": "nullclaw",
  "name": "NullClaw",
  "homepage": "https://github.com/nullclaw/nullclaw",
  "description": "Fastest, smallest, and fully autonomous AI assistant infrastructure written in Zig",
  "executables": [
    "nullclaw"
  ],
  "dotfiles": {
    "paths": [
      "~/.nullclaw/config.json"
    ],
    "secret": [],
    "secret_paths": [
      {
        "file": "~/.nullclaw/config.json",
        "format": "json",
        "match": {
          "key_path": [
            "models.providers.*.api_key",
            "channels.*.accounts.*.bot_token",
            "channels.*.accounts.*.webhook_secret"
          ]
        }
      }
    ]
  },
  "commands": {
    "format": 1,
    "label": "nullclaw",
    "description": "Chat with the agent or start the gateway. Onboarding, channels, services and migration are left out.",
    "quality": "ai-draft",
    "parser": {
      "end_of_options": "--",
      "interleave": "permute",
      "long_equals": true,
      "short_attached": false,
      "short_bundles": false
    },
    "subcommand": [
      {
        "path": [
          "agent"
        ],
        "label": "Talk to the agent",
        "description": "Send a single message, or leave the message empty for interactive chat.",
        "source": [
          {
            "id": "readme",
            "kind": "help",
            "url": "https://raw.githubusercontent.com/nullclaw/nullclaw/HEAD/README.md",
            "revision": "HEAD 2026-10-27",
            "evidence": "nullclaw agent -m \"Hello, nullclaw!\"\nnullclaw agent\nnullclaw agent --agent <name>\n| `agent -m \"...\"` | Single message mode |\n| `agent` | Interactive chat mode |"
          }
        ],
        "field": [
          {
            "id": "message",
            "label": "Message",
            "description": "Leave empty for interactive chat.",
            "type": "string",
            "option": [
              "-m"
            ],
            "sources": [
              "readme"
            ]
          },
          {
            "id": "agent",
            "label": "Agent profile",
            "description": "Named agent profile from agents.list.",
            "type": "string",
            "option": [
              "--agent"
            ],
            "sources": [
              "readme"
            ]
          }
        ],
        "task": [
          {
            "id": "chat",
            "label": "Interactive chat",
            "fields": [
              "agent"
            ],
            "required": []
          },
          {
            "id": "single",
            "label": "Single message",
            "fields": [
              "message",
              "agent"
            ],
            "required": [
              "message"
            ]
          }
        ],
        "group": [
          {
            "id": "basic",
            "label": "Basic",
            "fields": [
              "message",
              "agent"
            ]
          }
        ]
      },
      {
        "path": [
          "gateway"
        ],
        "label": "Start the gateway",
        "description": "Run the gateway (default 127.0.0.1:3000).",
        "source": [
          {
            "id": "readme",
            "kind": "help",
            "url": "https://raw.githubusercontent.com/nullclaw/nullclaw/HEAD/README.md",
            "revision": "HEAD 2026-10-27",
            "evidence": "nullclaw gateway                # default: 127.0.0.1:3000\nnullclaw gateway --port 8080    # custom port"
          }
        ],
        "field": [
          {
            "id": "port",
            "label": "Port",
            "type": "integer",
            "option": [
              "--port"
            ],
            "sources": [
              "readme"
            ]
          }
        ],
        "task": [
          {
            "id": "serve",
            "label": "Start gateway",
            "fields": [
              "port"
            ],
            "required": []
          }
        ],
        "group": [
          {
            "id": "basic",
            "label": "Basic",
            "fields": [
              "port"
            ]
          }
        ]
      }
    ]
  }
}