CLI and automation

eidos is an agent-first Rust CLI for the open Eidos File format. It reads and modifies files directly and does not connect to a running Eidos application.

Install and create a file Complete the first visual workflow in a few commands.

Automate safely Use context, revision checks, atomic apply, and full validation.

Serve the local editor Open the shared Eidos File UI for one path on localhost.

Command model

The help output uses command-first syntax:

eidos inspect tracker.eidos
eidos context tracker.eidos Tasks --fields Title,Status --limit 50
eidos validate tracker.eidos --level full

File-first forms such as eidos tracker.eidos inspect are also accepted for compatibility. New scripts should prefer command-first syntax so they match eidos --help.

Successful commands write one JSON document to stdout. Failed commands write one JSON error document to stderr and return a nonzero exit status.

Supported responsibility

The CLI creates, inspects, queries, mutates, validates, and serves Eidos Files. It does not manage Eidos Lite Space lifecycle, ordinary documents, application RPC, version history, or Sync. Use normal file tools for ordinary files and Graft-aware workflows for history.

Raw SQLite writes are not a supported automation interface.