Flixa CLI

AI coding assistant CLI.

Install

npm install -g @deniai/flixa

or

pnpm install -g @deniai/flixa

or

bun install -g @deniai/flixa

Quick start

flixa login
flixa chat

Commands

Login

Log in to Flixa or save a BYOK API key for another provider.

flixa login
flixa login --provider anthropic
flixa login --provider openai
flixa login --provider custom-openai --base-url http://localhost:1234/v1

Supported providers:

• flixa
• openai
• anthropic
• google
• openrouter
• custom-openai

Notes:

• flixa uses browser-based device auth.
• Other providers use an API key prompt.
• custom-openai requires --base-url or an entered base URL.
• Logging in also sets the selected provider as the default provider.

Logout

Remove stored credentials for a provider.

flixa logout
flixa logout --provider anthropic

This removes saved credentials only. It does not undo Claude Code configuration changes.

Provider management

Inspect configured providers and switch the default provider.

flixa providers list
flixa providers current
flixa providers set-default anthropic

Model selection

Set the default model for the current or specified provider.

flixa model
flixa model --provider anthropic
flixa model claude-sonnet-4-0 --provider anthropic
flixa model gpt-4.1 --provider openai

For providers with configurable endpoints, you can also pass --base-url.

Chat

Start the interactive chat interface.

flixa chat
flixa chat --provider anthropic

Claude Code integration

Configure Claude Code to use Flixa or Anthropic credentials.

flixa claude-code
flixa claude-code --provider flixa
flixa claude-code --provider anthropic

What this changes:

• ~/.claude.json
  • hasCompletedOnboarding
  • primaryApiKey
• ~/.claude/settings.json
  • env.ANTHROPIC_API_KEY
  • env.ANTHROPIC_BASE_URL when supported by the provider

Safety features:

• Prompts before replacing existing values
• --dry-run shows planned changes without writing files
• Creates *.bak backups before writing changed Claude settings files
• Stops with an error if an existing Claude JSON file is invalid instead of overwriting it

Supported providers for claude-code:

• flixa
• anthropic

Usage

Show account usage information.

flixa usage

Codex

Run the Codex-related command flow.

flixa codex

Configuration and storage

Flixa stores local config in:

• ~/.flixa/config.json

This includes things like:

• default provider
• provider-specific base URLs
• provider-specific default models

Credentials are stored per provider using the best available backend for your OS:

• macOS: Keychain via security
• Linux: secret-tool when available, otherwise plaintext fallback in ~/.flixa/
• Windows: DPAPI-backed local encrypted file

Fallback credential files may include:

• ~/.flixa/credentials
• ~/.flixa/credentials-<provider>

Claude Code integration writes to:

• ~/.claude.json
• ~/.claude/settings.json

Troubleshooting

Linux: secret-tool not installed

If secret-tool is unavailable, Flixa falls back to a file in ~/.flixa/ with best-effort restricted permissions and prints a warning.

Already logged in

If a provider already has saved credentials, run:

flixa logout --provider <provider>

Then log in again.

Claude Code still points to the old provider

flixa logout does not modify Claude Code config files. Re-run:

flixa claude-code --provider <provider>

Custom OpenAI-compatible endpoint

Use:

flixa login --provider custom-openai --base-url http://your-endpoint/v1

Development

bun install
bun run dev
bun run build