How go2sun/centeros works
CenterOS is a local, file-based workspace that gives an AI assistant persistent instructions, memory, knowledge, and repeatable workflows. The main user journey is to start a session in an AI harness, orient it with the repository’s startup or bootstrap instructions, then create or run a workflow and retain its outputs and log. Separate branches support wiki synthesis and dashboard pages. The README documents these capabilities; sampled implementation evidence is limited to the dashboard-page generator, so other internal links are shown only where documented.
Main entry points: create-dashboard-page.py Page Generator · index.html Dashboard Shell · workflows Dashboard Pages · STARTUP.md First-Time Setup
Components 21
Session Orientation
- First-Time Setup
STARTUP.md - Session Orientation
BOOTSTRAP.md - Harness Rules
AGENTS.md - Identity and Profile
SOUL.md - User Preferences
PRINCIPAL.md - System Map
SYSTEM_INDEX.md
Workflow System
- Workflow Folders
workflows - Workflow Instructions
workflows/CONTEXT.md - Workflow Logs
workflows/LOG.md
Knowledge Base
- Wiki Source Material
wikis - Wiki Knowledge
wikis - Durable Memory
memory/MEMORY.md - Memory Log
memory/LOG.md
Dashboard Interface
- Dashboard Shell
dashboard/index.html - Dashboard Pages
dashboard/workflows - Page Generator
dashboard/create-dashboard-page.py
Reusable Scaffolding
- Dashboard Page Template
templates/dashboard-page/page.html - Workflow Template
templates/workflow/README.md - Wiki Template
templates/wiki/README.md
Other components
- User
- AI Harness
Connections 21
- User → AI Harness: opens workspace
- AI Harness → First-Time Setup: follows on setup
- AI Harness → Session Orientation: follows each session
- AI Harness → Harness Rules: reads rules
- AI Harness → Identity and Profile: reads identity
- AI Harness → User Preferences: reads preferences
- AI Harness → System Map: reads map
- AI Harness → Workflow Folders: creates or runs
- AI Harness → Workflow Instructions: follows instructions
- AI Harness → Workflow Logs: appends run
- AI Harness → Wiki Source Material: reads sources
- AI Harness → Wiki Knowledge: synthesizes pages
- AI Harness → Durable Memory: maintains memory
- AI Harness → Memory Log: records changes
- User → Dashboard Shell: views dashboard
- Dashboard Shell → Dashboard Pages: links pages
- Page Generator → Dashboard Page Template: renders template
- Page Generator → Dashboard Pages: writes page
- Page Generator → Dashboard Shell: updates sidebar
- AI Harness → Workflow Template: uses to scaffold
- AI Harness → Wiki Template: uses to scaffold