Commands

config

Inspect and modify configuration.

daysurface config show                           # view full config
daysurface config get llm_config.cache_enabled   # get a single value
daysurface config set logging.verbose false      # set an override

Subcommand	Description
`show`	Display the full configuration
`get <key>`	Get a single value by dot-separated key
`set <key> <value>`	Write an override to `.global_config.yaml`

secrets

Keep API keys and OAuth credentials in your OS keyring instead of a plaintext file on disk.

daysurface secrets list                        # masked by default
daysurface secrets set GOOGLE_CLIENT_SECRET    # prompts, or pipe with --stdin
daysurface secrets get OPENAI_API_KEY --reveal # show the full value
daysurface secrets import --file .env.prod     # load a .env into the keyring
daysurface secrets delete STALE_KEY

Subcommand	Description
`list`	List known secrets, values masked
`set <key> [value]`	Write a secret. Pass `-` or `--stdin` to read the value from stdin
`get <key>`	Read a secret, masked unless `--reveal`
`delete <key>`	Remove a secret. Deleting an absent key is a no-op success
`import`	Read a `.env` file (or stdin) into the keyring (`--file`, `--stdin`, `--interactive`)
`export`	Print keyring contents in `.env` form, masked unless `--reveal`

The server does not read the keyring. common/global_config.py loads secrets from .env, so secrets set alone will not make a credential visible to daysurface-serve. The keyring is the safe place to hold them; .env is what the process reads. To go from one to the other:

daysurface secrets export --reveal > .env

For a hosted deployment, set the variables in your platform's environment instead - see Deployment.

doctor

Run health checks on the project environment.

daysurface doctor          # check everything
daysurface doctor --fix    # auto-fix what it can

Checks Python version, uv installation, dependency sync, config validity, .env file, pre-commit hooks, and git status.

completions

Install shell tab-completions for faster usage.

daysurface completions install bash    # append to ~/.bashrc
daysurface completions install zsh     # append to ~/.zshrc
daysurface completions install fish    # append to config.fish
daysurface completions show bash       # print script to stdout

update

Check for a newer version and upgrade.

daysurface update

telemetry

Manage anonymous usage telemetry.

daysurface telemetry status     # show enabled/disabled
daysurface telemetry disable    # opt out
daysurface telemetry enable     # opt back in

You can also set CLI_TELEMETRY_DISABLED=1 to disable.

security

Show security ratings and links to the Snyk and Socket.dev assessments.

daysurface security

greet

A no-op smoke-test command kept for verifying an install end to end. It is not part of the product surface.

daysurface greet Alice
# Hello, Alice!

Commands

On this page