ALAN(1) /proc/0001 idle
GitHub ↗
VOL. 01 · ALAN9 PERSONAL COMPUTING ENVIRONMENT RUST 2024 · APACHE-2.0 · EARLY DEVELOPMENT

Everything is a file. Even an agent.

A programmable personal computing environment built on —where agents are ordinary processes in and state lives in .

Minimalist Klein Blue and carbon-ink Risograph illustration of a rabbit wearing 1980s headphones at a retro terminal with punched Turing paper tape.
FIG. 01 · RISOGRAPH PLATE
Plan 9 discipline meets 1980s print craft. Click any dashed to execute it directly in the shell.
alan-shell — /agent/root aP/1 · Tab to complete
alan9:/$

01 · ARCHITECTURE

Built like an operating system, not a chat wrapper.

Ordinary processes

Agent-ness is a file-layout convention, never a second Kernel Process type. owns lifecycle truth; projects its live view.

Explicit boundaries

Launching alan never exposes your host directory. Host Mounts, Skills (), and Host Store credentials stay strictly separated.

Terminal-first

No Electron shell or sidebar. Run interactively inside modern terminal hosts like Herdr, or pipe tasks cleanly through stdin and stdout.


            

02 · STANDARD NAMESPACE

Seven directories. Zero hidden globals.

Process table and lifecycle truth — PID, descriptors, credentials, and exit state.
AgentFS views served by the Agent Runtime Service, with /agent/root for the root process.
Service Handle Registry — rendezvous tree for mountable aP file-server handles.
Reusable Tools and Agent Executables, including Quartermaster at /bin/q.
Immutable Skill package content projected at /lib/pkg/<id> on explicit reference.
Manual pages for commands, file servers, and architectural conventions.
Explicitly authorized Host Mounts. Host directories never leak in implicitly.

Quartermaster (/bin/q) installs Skills strictly from authorized namespace paths (q install --name my-skills /mnt/import/my-skills) — never raw host paths or hidden URLs.

03 · TERMINAL INTERFACE

just install && alan

            

ALAN-SHELL PALETTE

:

KEYBOARD SHORTCUTS

/Open command palette ?Show keyboard shortcuts j / kJump to next / previous section dToggle TERM=dumb monochrome mode TabAutocomplete inside alan-shell ↑ / ↓Browse command history inside alan-shell