The Armory

Practical command-line tools for backups, security checks, service health, diagnostics, release hygiene, and agent-driven automation.

First Run (Mac, 10 Seconds)

# Civilian start (plain language onboarding)
./setup.sh

# Crystal Saga start (Receive the Crystal)
./awakening.sh

Choose Your Path

Crystal Saga Mode	Civilian Mode
Final Fantasy flavor with clear technical instructions.	Plain-language onboarding for fast operational use.
Open Crystal Saga Guide	Open Civilian Guide
Dashboard (Saga)	Dashboard (Civ)

Shared Essentials

# 1) Civilian-first bootstrap
./setup.sh --mode civ --command-word armory

# 2) Crystal Saga bootstrap (power-user lane)
./setup.sh --mode saga --command-word crystal

# 3) Check active mode
armory civs status

# 4) Switch modes
armory civs off   # Crystal Saga Mode (mode=saga)
armory civs on    # Civilian Mode (mode=civ)

Single shared mode contract across dispatcher, dashboard, installer, and agent reports:

• key: mode
• values: saga | civ
• default: saga

Agent-First Prompt Pattern

Use this pattern with Codex/OpenClaw:

Scout Armory for this task, return a shortlist, wait for my approval, equip selected tools, and report back in active mode.

Concrete CLI route:

armory quartermaster scout --task "release readiness for this repo"
armory quartermaster plan --task "release readiness for this repo"
armory quartermaster equip --from-last-plan --approve
armory quartermaster report --from-last-plan

Full Guides

1. Crystal Saga Guide
2. Civilian Guide

Both guides use the same commands and system behavior; only language/presentation differs by mode.

Core References

• Machine manifest
• Shop catalog
• Dashboard app
• Quartermaster automation
• OpenClaw ecosystem references
• Agent contract
• Agent doctrine
• Telemetry contract
• Contributing
• Documentation contract
• Policies, Branch protection, Deprecation

---

Protected by the Seven Shadows

Explore the Vault ->

Part of Sovereign - The Shadow Dominion.