degoog-cli

CLI tool for scaffolding degoog extensions and searching your instance from the terminal.

Install

curl -fsSL https://raw.githubusercontent.com/degoog-org/cli/main/install.sh | sh

The installer asks whether you want Docker or a native binary. Docker is recommended - no runtime dependencies, always up to date with a pull. Native binaries are available for Linux x64/arm64 and macOS x64/arm64. Windows users should use Docker.

Once installed, run it from anywhere:

degoog-cli

Manual install for the nerds

Docker Compose

Grab the docker-compose.yml from this repo and run it from any directory:

curl -fsSL https://raw.githubusercontent.com/degoog-org/cli/main/docker-compose.yml -o docker-compose.yml
docker compose run --rm degoog-cli

Extensions are created in whichever directory you run it from. Config persists at ~/.config/degoog on your host.

Native binary

Download the binary for your platform from releases, make it executable, and put it on your $PATH:

# Linux x64 example
curl -fsSL https://github.com/degoog-org/cli/releases/latest/download/degoog-cli-linux-x64 \
  -o /usr/local/bin/degoog-cli
chmod +x /usr/local/bin/degoog-cli

Available filenames: degoog-cli-linux-x64, degoog-cli-linux-arm64, degoog-cli-darwin-x64, degoog-cli-darwin-arm64.

Setup

Run login once to point the CLI at your instance and save your author details:

degoog-cli

Pick Login / Setup from the menu. Instance URL and API key unlock the search command.

Search

Select Search from the menu to search your degoog instance directly from the terminal. Results show inline with title, URL, snippet, and sources. Pick a result to open it in your browser or keep searching.

Requires an instance URL to be configured.

Create an extension

Select Create extension from the menu and follow the prompts, or skip them with flags:

degoog-cli create --name my-engine --type engine --out ./extensions

Any flag you omit will still be asked interactively. Available types:

Type	What it is
engine	Custom search engine
transport	Custom HTTP fetch strategy
autocomplete	Search suggestions provider
theme	UI theme with CSS variables and optional template overrides
plugin-bang	Bang command (!trigger query)
plugin-slot	Panel injected into search results
plugin-tab	Custom tab in search results
plugin-intercept	Modifies queries before search
plugin-middleware	Hooks into request flows
plugin-routes	Custom HTTP endpoints

What gets generated

Every extension gets:

• index.ts - entry file pre-filled with the correct contract for the type you picked
• README.md - fill this in, it shows as docs on the extension's settings page
• author.json - auto-filled from your login details

Themes also get style.css with all CSS variables pre-filled to the degoog defaults (light and dark), plus a templates/logo.html example showing how to override a template section.

Plugin types also have isClientExposed already in the template. Set it to true if your plugin causes the browser to fetch external URLs directly, false if everything goes through the server. Leaving it unset shows a warning badge in degoog settings.

Docker Compose

If you prefer compose over the wrapper script:

docker compose run --rm degoog-cli

Extensions land in your current directory. Config persists at ~/.config/degoog on your host.

Dev (building from source)

Requires Bun.

bun install
bun run dev        # run without building
bun run build      # produces binaries in dist/ for all platforms