Skip to content
Eidos Docs

CLI quickstart

The standalone eidos CLI works directly with .eidos files. It does not require Eidos Lite or a background service.

1. Install the CLI

Section titled “1. Install the CLI”
Terminal window
curl -fsSL https://download.eidos.space/cli/install.sh | sh

Restart your terminal if eidos is not on your PATH. Run eidos --help to check the installation.

2. Optional: initialize the Agent Skill

Section titled “2. Optional: initialize the Agent Skill”

The CLI includes an AI agent skill for coding assistants. You do not need Node.js or npx:

Terminal window
# Current project
eidos self skill init


# Global configuration for all projects
eidos self skill init --global

Use eidos self skill init --space <DIR> to target another folder. The tool will not overwrite modified skill files without --force.

3. Create a file with a table

Section titled “3. Create a file with a table”
Terminal window
eidos file new example.eidos \
  --table Tasks \
  --label-field Title \
  --fields '[{"name":"Title","type":"text"},{"name":"Status","type":"select"}]'

The CLI makes this initial table the default table. It creates a Grid view for the table. Fields accept empty values by default.

4. Open the local editor

Section titled “4. Open the local editor”
Terminal window
eidos serve example.eidos --open

The server listens on 127.0.0.1 by default. It opens the shared editor UI in your browser. It writes committed changes directly to example.eidos. To access the editor from another local device, run eidos serve example.eidos --lan. Press Ctrl + C to stop the server.

Continue with the CLI and automation guide. To publish a read-only web copy, follow Publishing with the CLI. To keep an editor connected to local files, use eidos serve.