Bare OS agent — Markdown workspace

This tree follows the agent Markdown workspace convention: “soul” files under workspace/ define personality, rules, and memory. /bin/agent loads them into the LLM system prompt on each session (after seeding from /share/agent-workspace/ on the system drive if ~/.agent/workspace/SOUL.md is missing).

Layout (personal Hyperdrive)

Path	Role
`~/.agent/workspace/`	Agent brain — git-trackable, portable across peers
`~/.agent/workspace/skills/`	Modular skills — one folder per skill, each with `SKILL.md` (optional YAML frontmatter)
`~/.agent/workspace/memory/`	Daily append logs `YYYY-MM-DD.md` (optional)
`~/.agent/skills/`	Optional global skills (lower precedence than `workspace/skills/` when names collide)
`~/.agent/config.json`	API URL, key, model (existing agent config)
`~/.agent/skill-loader.js`	Host stub for `discoverSkills` / `loadSkill` (in-image agent uses bundled discovery + `read_skill` tool)
`~/.agent/loader.js`	Stub / hook for host-side experimentation (not used by `/bin/agent` bundle)
`~/.agent/index.js`	Stub factory reference (in-image agent uses built-in loader)

Skills

Add a directory under ~/.agent/workspace/skills/<skill-id>/ with a SKILL.md file.
Use YAML frontmatter for name, description, version, etc. The compact system prompt lists id, name, and a short description only.
During a session, the model loads the full document with the read_skill tool (do not paste huge skills into the user channel unless asked).
Shared skills can live under ~/.agent/skills/; keep workspace/skills/ for machine-local or repo-specific behavior.

Seeded examples in this repo (under skills/): p2p-os-status, bare-os-kernel-proc, bare-os-super-developer, holesail (managed state.json, seed/key, stock bare-www-* / bare-ssh-*), and hdms (Hyperdrive mounts and invite/pair).

After agent --config / --setup (or changing owner_name / agent_label via edit_agent_config), IDENTITY.md and USER.md are regenerated from config.json so the workspace matches the operator and agent label.

Editing

Change files under ~/.agent/workspace/ on your personal drive.
Restart agent or start a new session so the system message reloads.
Keep SOUL.md / AGENTS.md stable within a session if you follow the drift guard in AGENTS.md.

Defaults in this repository

Source templates: packages/bare-os-coreutils/share/agent-workspace/ — copied to kernel/share/agent-workspace/ during npm run build -w bare-os-coreutils for seeding into new homes.

Compatibility

File names and load order match common agent Markdown layouts so templates can be dropped into workspace/ with minimal edits.

3.0 KiB Raw Blame History