Eidos CLI

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

Eidos CLI 2.0

Eidos CLI 2.0 reorganizes commands into clear, atomic namespaces:

• file: File-level operations (new, inspect, validate, repair)
• schema: Relational structure (dump, apply, table, field, view)
• data: Rows and records (query, mutate, compact, asset)
• serve: Local/LAN web editor
• cloud: Account and remote services (login, whoami, logout, publish, collect)
• self: CLI maintenance and skills (skill, upgrade)
• plugin: Local plugin package management (list, install, remove, inspect)

Legacy 1.x flat commands (eidos create, eidos context, eidos rows, etc.) remain available as hidden aliases for backward compatibility.

Install

Install Eidos CLIInstall the standalone command, create a file, and open the local editor.

Basics

Use command-first namespaced syntax:

eidos file inspect tracker.eidos
eidos data query tracker.eidos Tasks --fields Title,Status --limit 50
eidos file validate tracker.eidos --level full

Commands print readable output by default. Add --json when a script or Agent needs the stable machine-readable result:

eidos --json data query tracker.eidos Tasks --fields Title,Status --limit 50

Use eidos --help to list commands, and eidos <command> --help for the options of one command.

File editor plugins

Use eidos plugin to inspect and manage locally installed plugins:

eidos plugin list
eidos plugin install ./my-plugin.eidos-plugin
eidos plugin remove com.example.plugin

To create and package new plugins, use @eidos.space/plugin-tools:

npx @eidos.space/plugin-tools create my-plugin
npx @eidos.space/plugin-tools check
npx @eidos.space/plugin-tools pack

Follow the plugin development guide for a complete CSV editor walkthrough.

Initialize the Agent Skill

The CLI bundles the Eidos Skill, so an Agent setup does not need Node.js, npm, or npx:

# Install in the current Space/project.
eidos self skill init

# Install for the current user and all projects.
eidos self skill init --global

Use eidos self skill init --space <DIR> for another Space. The command writes the standard .agents/skills/eidos layout, is safe to repeat, and refuses to replace locally edited files unless --force is explicit. Start a new Agent task after initialization.

Advanced

Safe automationRead context, apply revision-checked changes, and validate the result.

Serve the local editorOpen one Eidos File in the shared editor on localhost or a trusted network.

Publish from the terminalPublish an Eidos File, Markdown document, or form to a stable address.

The CLI manages Eidos Files, not Eidos Lite Spaces or local history. Use Eidos Lite when you need folder navigation, Space history, or Sync.

For Agent workflows, the safe automation guide also covers intent commands for schema changes, Runtime-backed Formula/Lookup Fields, business-key mutations, and atomic mixed mutation batches, plus safe File-field attachment import and verification.