CLI

Athas ships with a small CLI so you can jump into the right workspace or tool without leaving your shell.

Install the command

Install the athas command from Settings > General > Terminal Command inside the app. Once installed, make sure the generated bin directory is in your PATH.

Usage

athas [paths...]
athas open <paths...>
athas web <url>
athas terminal [command...]
athas remote <connection-id> [name]

Open files and folders

These commands open files or folders in Athas:

athas index.html
athas src/main.rs:120
athas .
athas open README.md docs/architecture.md

Athas automatically chooses the right surface for many file types:

• Images open in the image viewer
• PDF files open in the PDF viewer
• .db, .sqlite, .sqlite3, and .duckdb files open in the database viewer
• Markdown, HTML, and CSV files can be opened and then previewed inside Athas

Open the web viewer

Use the built-in web viewer without opening the app first:

athas web https://athas.dev/docs

Open a terminal tab

Open a blank terminal in the current working directory:

athas terminal

Open a terminal and run a command immediately:

athas terminal npm test

The terminal uses the directory where you ran the command as its working directory.

Open a remote workspace

If you already saved a remote connection in Athas, you can reopen it directly from the shell:

athas remote conn-123
athas remote conn-123 "My Server"

Use the saved connection id from Athas' remote connections UI.

Help

Print the built-in usage text:

athas --help