Earth Game
A private, offline companion for choosing quests, taking the next action,
closing open loops, and reviewing your direction before drift sets in.
Earth Game uses Python's standard library and SQLite. It has no third-party
dependencies, accounts, outbound requests, scoring, or AI-generated advice.
Requirements
Python 3.8 or newer
A Unix-like terminal
Install on Arch Linux
Earth Game is available from the AUR:
After installation, run earth or earth-game from anywhere.
Quick start
Prefer a browser? Start the same app as a local-only web UI:
It opens a private session URL on http://127.0.0.1:8765/ and uses the same
database as the CLI. Stop it with Ctrl-C. It never binds to your LAN or makes
external requests.
Commands prompt for missing text. Options also support non-interactive use:
Run ./earth --help or ./earth COMMAND --help for the complete interface.
See USAGE.md for complete real-world walkthroughs.
Commands
earth init creates local storage without overwriting an existing database.
earth character show|edit manages values, strengths, frictions, purpose,
and anti-vision.
earth quest add|list|start|done|drop manages quests. Only one quest can be
current.
earth loop add|list|close captures and closes unresolved tasks or concerns.
earth today shows the current quest, next action, open-loop count, and
review status.
earth review records five short reflections. Pass --update-quest to use
the --next answer as the current quest's next action.
earth export [PATH] exports all data as readable JSON. Existing files are
never overwritten.
earth web starts the local browser UI. Use --no-open or choose a port with
--port PORT.
Typical loop
Data and privacy
The default database is:
Set EARTH_GAME_DB to use another path:
The database and JSON exports are created with private permissions on Unix.
Earth Game makes no external network requests; the web command listens only on
the local loopback address and requires the private session URL printed at
startup.
To back up or restore, copy the SQLite database while no Earth Game command is
running. ./earth --help prints the exact active data path.
Tests
Structure
earth contains CLI parsing and terminal interaction.
earth_core.py contains SQLite and shared domain operations.
earth_web.py contains the local HTTP server and HTML interface.
See ROADMAP.md for the product decisions and future-change rules.