{
  "id": "code-server",
  "name": "code-server",
  "homepage": "https://github.com/coder/code-server",
  "description": "VS Code in the browser.",
  "executables": [
    "code-server"
  ],
  "dotfiles": {
    "paths": [
      "[configHome]/code-server/config.yaml",
      "[xdgData]/code-server/User/"
    ],
    "exclude": [
      "[xdgData]/code-server/extensions/",
      "[xdgData]/code-server/coder-logs/",
      "[xdgData]/code-server/heartbeat"
    ],
    "secret": [],
    "side_effect": false,
    "secret_paths": [
      {
        "file": "[configHome]/code-server/config.yaml",
        "match": {
          "key_path": [
            "password",
            "hashed-password"
          ]
        }
      }
    ]
  },
  "commands": {
    "format": 1,
    "label": "Run code-server",
    "description": "Serve VS Code in the browser, or manage its extensions. Passwords and tokens are deliberately not fields; set them in the config file or environment.",
    "quality": "ai-draft",
    "parser": {
      "end_of_options": "--",
      "interleave": "permute",
      "long_equals": true,
      "short_attached": true,
      "short_bundles": false
    },
    "source": [
      {
        "id": "help",
        "kind": "help",
        "url": "https://github.com/coder/code-server/blob/main/src/node/cli.ts",
        "revision": "2026-10-27",
        "evidence": "code-server [options] [path]\n--auth  The type of authentication to use. (password | none)\n--bind-addr  Address to bind to in host:port. You can also use $PORT to override the port.\n--config  Path to yaml config file. Every flag maps directly to a key in the config file.\n--user-data-dir  Path to the user data directory.\n--extensions-dir  Path to the extensions directory.\n--disable-telemetry  Disable telemetry.\n--open  Open in browser on startup. Does not work remotely.\n--log  trace | debug | info | warn | error\n--list-extensions  List installed VS Code extensions.\n--force  Avoid prompts when installing VS Code extensions.\n--install-extension  Install or update a VS Code extension by id or vsix. To install a specific version provide `@${version}`.\n--uninstall-extension  Uninstall a VS Code extension by id.\n"
      }
    ],
    "field": [
      {
        "id": "folder",
        "label": "Folder to open",
        "type": "path",
        "position": 0,
        "path": {
          "kind": "directory",
          "role": "input"
        },
        "sources": [
          "help"
        ]
      },
      {
        "id": "bind_addr",
        "label": "Bind address",
        "description": "host:port, e.g. 127.0.0.1:8080.",
        "type": "string",
        "option": [
          "--bind-addr"
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "auth",
        "label": "Authentication",
        "type": "enum",
        "option": [
          "--auth"
        ],
        "choices": [
          {
            "value": "password",
            "label": "password"
          },
          {
            "value": "none",
            "label": "none"
          }
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "config",
        "label": "Config file",
        "type": "path",
        "option": [
          "--config"
        ],
        "path": {
          "kind": "file",
          "role": "input"
        },
        "sources": [
          "help"
        ]
      },
      {
        "id": "user_data_dir",
        "label": "User data directory",
        "type": "path",
        "option": [
          "--user-data-dir"
        ],
        "path": {
          "kind": "directory",
          "role": "input"
        },
        "sources": [
          "help"
        ]
      },
      {
        "id": "extensions_dir",
        "label": "Extensions directory",
        "type": "path",
        "option": [
          "--extensions-dir"
        ],
        "path": {
          "kind": "directory",
          "role": "input"
        },
        "sources": [
          "help"
        ]
      },
      {
        "id": "disable_telemetry",
        "label": "Disable telemetry",
        "type": "boolean",
        "option": [
          "--disable-telemetry"
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "open",
        "label": "Open in browser",
        "type": "boolean",
        "option": [
          "--open"
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "log",
        "label": "Log level",
        "type": "enum",
        "option": [
          "--log"
        ],
        "choices": [
          {
            "value": "trace",
            "label": "trace"
          },
          {
            "value": "debug",
            "label": "debug"
          },
          {
            "value": "info",
            "label": "info"
          },
          {
            "value": "warn",
            "label": "warn"
          },
          {
            "value": "error",
            "label": "error"
          }
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "install_extension",
        "label": "Install extension",
        "description": "publisher.name, optionally @version, or a .vsix path.",
        "type": "string",
        "option": [
          "--install-extension"
        ],
        "multiple": true,
        "sources": [
          "help"
        ]
      },
      {
        "id": "uninstall_extension",
        "label": "Uninstall extension",
        "type": "string",
        "option": [
          "--uninstall-extension"
        ],
        "multiple": true,
        "sources": [
          "help"
        ]
      },
      {
        "id": "list_extensions",
        "label": "List extensions",
        "type": "boolean",
        "option": [
          "--list-extensions"
        ],
        "sources": [
          "help"
        ]
      },
      {
        "id": "force",
        "label": "Skip install prompts",
        "type": "boolean",
        "option": [
          "--force"
        ],
        "sources": [
          "help"
        ]
      }
    ],
    "task": [
      {
        "id": "serve",
        "label": "Serve a folder",
        "fields": [
          "folder",
          "bind_addr",
          "auth",
          "disable_telemetry"
        ],
        "required": []
      },
      {
        "id": "install",
        "label": "Install an extension",
        "fields": [
          "install_extension",
          "force"
        ],
        "required": [
          "install_extension"
        ]
      },
      {
        "id": "list",
        "label": "List extensions",
        "set": {
          "list_extensions": [
            true
          ]
        },
        "lock": [
          "list_extensions"
        ],
        "fields": [
          "list_extensions"
        ],
        "required": []
      }
    ],
    "group": [
      {
        "id": "basic",
        "label": "Basic",
        "fields": [
          "folder",
          "bind_addr",
          "auth",
          "open"
        ]
      },
      {
        "id": "advanced",
        "label": "Advanced",
        "fields": [
          "config",
          "user_data_dir",
          "extensions_dir",
          "disable_telemetry",
          "log",
          "install_extension",
          "uninstall_extension",
          "list_extensions",
          "force"
        ]
      }
    ]
  }
}