Getting started
Boot the system
aios up
This boots the kernel (and the local model runtime, if installed), indexes the current directory
into the graph, and drops you into the ask REPL. Point it at a different project with aios up <dir>.
Check what is running at any time:
aios status
Open the dashboard
aios serve
Then open http://127.0.0.1:8017 in a browser. The dashboard is loopback-only by default (no
network exposure, no auth needed). On the live/desktop ISO this opens automatically in full screen.
Set your location
Most map and field tools work relative to a current location. Nothing is assumed for you — an asserted-but-wrong position is worse than none on a survival tool — so set it explicitly:
- On the map, pan so the centre crosshair is on you, click Set Home, then choose From map centre (or From GPS location if a receiver has a fix).
- From the CLI:
aios geo here "Manchester",aios geo here 53.48 -2.24, oraios geo here gps.
If a GPS receiver is present, the dashboard also adopts a fix automatically at startup when no location is set yet (it never overwrites one you set).
Do something useful
- Find the nearest drinking water: type it in the Assistant, or
aios geo near water. - Get walking directions: the Route panel, or
aios geo route "here" "town hall" --walk. - Ask about this machine or a codebase: the Assistant, or
aios ask "where is nginx configured?".
When something looks wrong
aios doctor
diagnoses the setup and, with --fix, offers to repair it. See System & data.