{
  "id": "happy-coder",
  "name": "Happy Coder",
  "homepage": "https://happy.engineering",
  "description": "CLI for operating AI coding agents from mobile devices.",
  "executables": [
    "happy"
  ],
  "dotfiles": {
    "paths": [],
    "secret": [
      "~/.happy/agent.key"
    ],
    "side_effect": false
  },
  "commands": {
    "format": 1,
    "label": "Start a Happy session",
    "description": "Start a Claude Code session with mobile control through happy. Subcommands (codex, daemon, auth, resume ...) and the claude flags Happy passes through are left out.",
    "quality": "ai-draft",
    "parser": {
      "end_of_options": "--",
      "interleave": "permute",
      "long_equals": false,
      "short_attached": false,
      "short_bundles": false
    },
    "source": [
      {
        "id": "help",
        "kind": "help",
        "url": "https://github.com/slopus/happy/blob/main/packages/happy-cli/src/index.ts",
        "revision": "2026-10-27",
        "evidence": "  happy --yolo             Start with bypassing permissions\n                            happy sugar for --dangerously-skip-permissions\n  happy --chrome           Enable Chrome browser access for this session\n  happy --no-chrome        Disable Chrome even if default is on\n  happy --no-sandbox       Disable Happy sandbox for this session\n  happy --js-runtime bun   Use bun instead of node to spawn Claude Code\n  happy --claude-env ANTHROPIC_BASE_URL=http://127.0.0.1:3456\nInvalid --js-runtime value: ${runtime}. Must be 'node' or 'bun'\nInvalid --claude-env format: ${envArg}. Expected KEY=VALUE\n"
      }
    ],
    "field": [
      {
        "id": "yolo",
        "label": "Bypass permissions",
        "description": "Shortcut for --dangerously-skip-permissions.",
        "type": "boolean",
        "option": [
          "--yolo"
        ],
        "effect": "exec",
        "sources": [
          "help"
        ]
      },
      {
        "id": "chrome",
        "label": "Chrome access",
        "type": "boolean",
        "option": [
          "--chrome"
        ],
        "false_option": "--no-chrome",
        "description": "Enable or disable Chrome browser access for this session.",
        "sources": [
          "help"
        ]
      },
      {
        "id": "no_sandbox",
        "label": "Disable sandbox",
        "type": "boolean",
        "option": [
          "--no-sandbox"
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "js_runtime",
        "label": "JavaScript runtime",
        "type": "enum",
        "choices": [
          {
            "value": "node",
            "label": "Node"
          },
          {
            "value": "bun",
            "label": "Bun"
          }
        ],
        "option": [
          "--js-runtime"
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "claude_env",
        "label": "Claude environment",
        "description": "KEY=VALUE passed to Claude Code, e.g. a custom ANTHROPIC_BASE_URL.",
        "type": "string",
        "option": [
          "--claude-env"
        ],
        "multiple": true,
        "sources": [
          "help"
        ]
      }
    ],
    "task": [
      {
        "id": "start",
        "label": "Start session",
        "fields": []
      },
      {
        "id": "custom_endpoint",
        "label": "Use a custom API endpoint",
        "fields": [
          "claude_env"
        ],
        "required": [
          "claude_env"
        ]
      }
    ],
    "group": [
      {
        "id": "basic",
        "label": "Basic",
        "fields": [
          "chrome",
          "yolo",
          "no_sandbox"
        ]
      },
      {
        "id": "advanced",
        "label": "Advanced",
        "fields": [
          "js_runtime",
          "claude_env"
        ]
      }
    ]
  }
}