Skip to content
Selesai Docs

Get started

Install Selesai

Use npm to install the package globally. Allow lifecycle scripts to run so Selesai can install and configure its bundled assets correctly.

npm install -g @selesai/code

The published package is @selesai/code and the binary is selesai.

To install directly from the public repository (builds the latest main from source):

npm install -g github:SelesaiInTech/selesai-code

Update often

Selesai and the Pi ecosystem move quickly. Important fixes, capabilities, and behavior changes can land daily, so update your installation often:

npm install -g @selesai/code@latest

Run Selesai

selesai

For a one-off run that does not leave a global install:

npx @selesai/code

First commands

Terminal window
# Ask the agent to explain a codebase
selesai "Explain this repository and tell me how to run its checks"


# Non-interactive, read-only request
selesai -p "Review the current git diff without editing files"

Configuration locations

Selesai stores state in two places:

  • ~/.selesai/agent/ — user-level state and resources
  • ./.selesai/ — project-local settings and resources

Sensitive credentials, such as API keys, are handled through token onboarding and provider configuration. Add provider credentials carefully and avoid committing them to version control.

Export a configured credential

Use the explicit auth commands when an external client needs the credential already configured in Selesai:

Terminal window
selesai auth print-api-key --provider openai --model gpt-5.5
selesai auth print-bearer-token --provider openai-codex --model gpt-5.5

These commands print the secret directly to stdout. Avoid terminal logs, shell tracing, command substitution in shared environments, and committed output files. OAuth bearer tokens refresh automatically when their remaining validity is too short.

Next steps

  • See Why Selesai for an evidence-backed comparison with Pi.
  • Browse the capabilities catalogue.
  • Configure Selesai: the Settings page covers the essentials, and the Customization page covers extension-level options.
  • Use the search box to find a specific extension or command.