Repolode
mayneyao

mayneyao/eidos

A single-file relational spreadsheet format built on SQLite, with a desktop app, CLI, browser editor and mobile apps for working with it.

Open-source alternative to:Notion

Stars
3,202
Forks
139
Open issues
8
Last commit
yesterday

What is it?

Eidos is a single-file relational spreadsheet format built on standard SQLite. Each Eidos File is an ordinary SQLite database that holds tables, typed fields and records, so the data stays in one portable file that any SQLite tool can open.

The project includes Eidos Lite, a desktop app for working with Eidos Files and regular Markdown or other files in a local folder. It also ships a browser editor at editor.eidos.space, an agent-oriented CLI that can create, inspect, query, update and serve Eidos Files, and experimental Android and iOS apps for local files, Markdown editing and LAN sync with the desktop app. Version history in Eidos Lite uses the Graft version-control system.

The codebase is a TypeScript and Rust monorepo. The core format and runtime live in a reusable npm package under MIT, while the apps are released under AGPL-3.0.

Key features

  • 01Stores tables, typed fields and records in a single standard SQLite file.
  • 02Desktop app for working with Eidos Files and ordinary files in a local folder.
  • 03Command-line tool to create, query, update and serve Eidos Files, aimed at agent workflows.
  • 04Browser editor for creating or editing .eidos files without installing anything.
  • 05Experimental Android and iOS apps with offline Markdown editing and LAN sync.

Use cases

  • Keeping a personal database of tasks, reading lists or notes in a portable file.
  • Letting an AI agent read and write structured data through the CLI.
  • Editing local Markdown and tables together on a phone without an account.

Quick start

  1. 1

    Run the official CLI install script for macOS or Linux from the README

  2. 2

    Create a new Eidos File with a Tasks table

    eidos file new example.eidos --table Tasks --label-field Title --fields '[{"name":"Title","type":"text"},{"name":"Status","type":"select"}]'
  3. 3

    Serve the file locally and open it in the browser

    eidos serve example.eidos --open

Things to know

  • The iOS app is experimental and must be built from source.
  • The project is licensed under AGPL v3, a copyleft license with obligations for derived works.

In collections

Topics

FAQ

What is eidos?
A single-file relational spreadsheet format built on SQLite, with a desktop app, CLI, browser editor and mobile apps for working with it. Eidos is a single-file relational spreadsheet format built on standard SQLite. Each Eidos File is an ordinary SQLite database that holds tables, typed fields and records, so the data stays in one portable file that any SQLite tool can open.
Is eidos free to use? What license does it have?
eidos is open source under the AGPL-3.0 license. Check the license terms before using it in commercial products.
Is eidos still maintained?
Actively maintained. The last commit to eidos was on Nov 5, 2026.
What can I use eidos for?
Keeping a personal database of tasks, reading lists or notes in a portable file. Letting an AI agent read and write structured data through the CLI. Editing local Markdown and tables together on a phone without an account.
How do I install eidos?
Run the official CLI install script for macOS or Linux from the README Create a new Eidos File with a Tasks table: eidos file new example.eidos --table Tasks --label-field Title --fields '[{"name":"Title","type":"text"},{"name":"Status","type":"select"}]' Serve the file locally and open it in the browser: eidos serve example.eidos --open
Where can I get eidos?
The source code and installation instructions are on GitHub: https://github.com/mayneyao/eidos

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects