Skip to main content

​
Main Command

lukan [options]

​
Options

OptionDescription
-p, --provider <name>Model provider (nebius, anthropic, fireworks, github-copilot, openai-codex, zai, ollama-cloud, openai-compatible, lukan-cloud)
-m, --model <name>Model name
--max-tokens <n>Max output tokens
--ui <mode>UI mode: ink (default), readline, web
--desktopLaunch in desktop mode (Tauri)
--session <id>Resume a session by ID
-c, --continueContinue the most recent session
-b, --browserEnable browser control tools
--browser-cdp <url>CDP endpoint URL for browser tools
--browser-visibleLaunch Chrome with visible window
--browser-profileUse default Chrome profile
--browser-allow-internalAllow navigation to internal/private URLs

​
Setup Commands

CommandDescription
lukan setupInteractive setup wizard (provider, API key, timezone)
lukan doctorShow configuration and diagnostic info
lukan updateSelf-update to latest version
lukan update --dailyInstall from the unstable/daily channel
lukan models [provider] [model]List and select models
lukan copilot-authAuthenticate with GitHub Copilot (OAuth device flow)
lukan codex-authAuthenticate with OpenAI Codex
lukan google-authAuthenticate with Google Workspace

​
Config Commands

lukan config get [key]           # Get config value (or all)
lukan config set <key> <value>   # Set config value
lukan config timezone            # Select timezone interactively
lukan config vision              # Select vision model

​
Plugin Commands

lukan plugin list                # List installed plugins
lukan plugin install <path>      # Install a plugin from local path
lukan plugin list-remote         # List plugins available from registry
lukan plugin remove <name>       # Remove a plugin
lukan plugin start <name>        # Start a plugin process
lukan plugin stop <name>         # Stop a plugin gracefully
lukan plugin status              # Show status of all plugins
lukan plugin logs <name>         # View plugin logs
lukan plugin config <name>       # Manage plugin configuration
lukan plugin exec <name> <cmd>   # Execute a plugin command
Plugins can also register CLI aliases. For example, the WhatsApp plugin registers lukan wa and the Email plugin registers lukan mail.

​
Skill Commands

lukan skill list                 # List available skills
lukan skill remove <name>        # Remove a skill
lukan skill env <name>           # Manage skill environment variables

​
Sandbox Commands

lukan sandbox status             # Show sandbox status
lukan sandbox on                 # Enable OS-level sandboxing
lukan sandbox off                # Disable sandboxing
lukan sandbox setup              # Install and configure bwrap
lukan sandbox uninstall          # Remove sandbox configuration

​
Worker Commands

lukan worker list                # List all workers
lukan worker add                 # Create worker interactively
lukan worker remove <id>         # Delete a worker
lukan worker pause <id>          # Pause a worker
lukan worker resume <id>         # Resume a worker
lukan worker runs <id>           # Show recent runs

​
Daemon Commands

lukan daemon start               # Start the worker daemon
lukan daemon stop                # Stop the worker daemon
lukan daemon status              # Show daemon status

​
Relay Commands

lukan login                      # Authenticate with Lukan Relay
lukan login --remote             # Remote/headless authentication
lukan logout                     # Disconnect from Relay
lukan relay status               # Show relay connection status
lukan relay disconnect           # Disconnect active relay session

​
WhatsApp Commands (Plugin)

lukan whatsapp                   # Start WhatsApp channel
lukan wa on                      # Enable WhatsApp
lukan wa off                     # Disable and stop daemon
lukan wa start                   # Start as background daemon
lukan wa stop                    # Stop daemon
lukan wa restart                 # Restart daemon
lukan wa status                  # Show configuration
lukan wa auth                    # Scan QR code to authenticate
lukan wa logout                  # Delete WhatsApp session
lukan wa allow <number>          # Whitelist a phone number
lukan wa deny <number>           # Remove from whitelist
lukan wa group add|remove|list   # Manage allowed groups
lukan wa groups                  # List available groups from bridge
lukan wa prefix [value]          # Get or set command prefix
lukan wa model                   # Select model interactively
lukan wa tools list|add|remove|reset   # Manage allowed tools
lukan wa dir list|add|remove|clear|on|off  # Manage allowed directories
lukan wa logs [-f] [-n <n>]      # Show daemon logs

​
Email Commands (Plugin)

lukan email                      # Start Email channel
lukan mail on                    # Enable Email
lukan mail off                   # Disable Email
lukan mail setup gmail|outlook <email>  # Setup with preset
lukan mail allow <email>         # Whitelist an email
lukan mail deny <email>          # Remove from whitelist
lukan mail prefix [value]        # Get or set subject prefix filter
lukan mail tools list|add|remove|reset  # Manage allowed tools
lukan mail status                # Show configuration
lukan mail test                  # Test SMTP and IMAP connections

​
In-Chat Commands

These commands work inside a chat session:
CommandDescription
/model [model]Open model picker or switch directly
/resumeResume a saved session (opens session picker)
/clearClear context and start fresh
/compactManually compact conversation
/memories [activate|deactivate|show|add <text>]Manage project memory
/gmemory [show|add <text>|clear]Manage global memory
/checkpointsOpen checkpoint viewer
/skillsList available skills
/events [clear]Switch to Event Agent view or clear events
/workersBrowse workers and their runs
/bgList background processes
/bg kill <pid>Kill background process
/bg logs <pid>View process output
!<command>Execute shell command, add output to context
/exitExit lukan

​
Keyboard Shortcuts

​
Chat Input

KeyAction
EnterSubmit message
TabAutocomplete command
Up/DownNavigate suggestions or history
EscapeCancel processing / clear input / open checkpoints
Shift+TabCycle permission mode (manual -> auto -> skip -> planner)
Ctrl+AMove cursor to start
Ctrl+EMove cursor to end
Ctrl+CExit lukan
Alt+BSend running Bash command to background
Alt+EToggle between Main and Event Agent views
Alt+LOpen/close unified event picker
Alt+AToggle auto/manual event forwarding mode
Alt+MShow memory viewer overlay
Alt+PToggle tool picker overlay
Alt+SToggle subagent picker overlay
Alt+TToggle task panel visibility
F9Open/minimize embedded terminal modal
Ctrl+Shift+F9Close and kill the terminal
Ctrl+Up/DownScroll terminal up/down
Ctrl+PageUp/PageDownHalf-page scroll in terminal

​
Session Picker

KeyAction
Up/DownNavigate sessions
EnterSelect session
SpaceMark for deletion
Alt+AToggle select all
Alt+XDelete marked
EscapeClose

​
Checkpoint Viewer

KeyAction
Up/DownNavigate checkpoints
EnterView diff / restore options
EscapeBack / close