Astonish

Appearance

Utility Commands ​

Miscellaneous commands for setup, status, and system management.

astonish setup ​

Interactive first-run wizard that configures your Astonish installation:

bash
astonish setup

Walks you through:

  • Selecting a storage backend (SQLite or PostgreSQL)
  • Selecting an AI provider and entering API keys
  • Choosing a default model
  • Configuring web search tools
  • Setting up browser automation
  • Initializing container sandboxes (optional)

astonish status ​

Display the current state of all Astonish subsystems:

bash
astonish status

Shows provider configuration, daemon status, MCP servers, memory state, and more.

astonish --version ​

Print version and build information:

bash
astonish --version
# or
astonish -v

INFO

This is a flag, not a subcommand. Use --version or -v.

astonish login ​

Authenticate with a remote platform instance:

bash
astonish login

Used when connecting the CLI to a cloud-deployed Astonish platform. After login, commands like chat, flows, and scheduler operate against the remote server.

astonish logout ​

Disconnect from the remote platform:

bash
astonish logout

astonish studio ​

Open the Studio web UI in your default browser:

bash
astonish studio

This is a convenience shortcut that ensures the daemon is running and opens the browser to http://localhost:9393. Local-only (cannot be used with remote servers).

astonish config ​

Manage configuration:

bash
astonish config

astonish tools ​

Manage MCP servers and tools:

bash
# List all available tools
astonish tools list

# List MCP servers
astonish tools servers

# Refresh tool cache
astonish tools refresh

# Enable/disable an MCP server
astonish tools enable <name>
astonish tools disable <name>

# Edit MCP configuration
astonish tools edit

# Browse MCP server store
astonish tools store

# Search tools
astonish tools search <query>

astonish sessions ​

Manage chat sessions:

bash
astonish sessions

astonish credentials ​

Manage the encrypted credential store (local-only):

bash
astonish credentials

astonish sandbox ​

Manage container sandboxes (local-only):

bash
astonish sandbox

Deprecated Commands ​

astonish memory ​

Deprecated

The memory CLI command is no longer available. Memory is managed through the agent's built-in memory tools during chat sessions, or via Studio Settings.

See Studio Overview for details on the web interface.