Arcana ARCANA
Docs Changelog Status
New in v0.4.0

Tab completion for bash, zsh, and fish shells.

Shell Completion

Arcana provides tab completion scripts for bash, zsh, and fish shells. Complete commands, subcommands, flags, model names, provider names, and skill names.

Setup

Bash

# Add to ~/.bashrc
eval "$(arcana completion bash)"

# Or install system-wide
arcana completion bash > /etc/bash_completion.d/arcana

Zsh

# Add to ~/.zshrc
eval "$(arcana completion zsh)"

# Or install to fpath
arcana completion zsh > "${fpath[1]}/_arcana"

Fish

# Add to ~/.config/fish/config.fish
arcana completion fish | source

# Or install permanently
arcana completion fish > ~/.config/fish/completions/arcana.fish

What Completes

ContextCompletes
arcana Commands: run, doctor, models, providers, etc.
arcana run --Flags: --json, --timeout, --skill, etc.
arcana models --provider Provider names: openai, anthropic, etc.
arcana skills list --query Skill names from installed skills
arcana theme set --name Theme names: dragon, bloodmoon, etc.
arcana cron add --schedule Common cron expressions

Verification

After setup, restart your shell and test:

# Type and press Tab
arcana ru     # → arcana run
arcana run -- # → --json --timeout --skill --ndjson ...
arcana theme set --name   # → dragon bloodmoon coven ...

Troubleshooting

Completion not working

  • Restart your shell after adding the eval line
  • Ensure arcana is on your PATH
  • Check that the completion script produces output: arcana completion bash

Zsh fpath issues

# Ensure compinit is loaded
autoload -Uz compinit && compinit

# Then add completion
eval "$(arcana completion zsh)"
CLI Commands Full command reference JSON & Exit Codes Machine-readable output for CI Quick Start Get running in under a minute
Last updated: Aug 19, 2026