How rogasper/onesist works
Onesist is a system-analyst workspace that manages project repositories, runs local CLI agents, and presents generated specifications and planning artifacts. The principal workflow is to open a project, provide or edit an FSD, invoke an agent, then inspect and maintain resulting API specs, ERDs, tasks, SIT cases, RTM links, diagrams, and documentation. The web UI reaches API routes through the server; task routes also read and update project files and database state. The README documents several capabilities whose implementation files were not sampled, so those links are documented rather than inferred from module names.
Main entry points: agent CLI Agent Engine · projects.$id.tsx Project Workspace · tasks.ts Task Routes · server.ts Web Server
Components 30
Project Workspace
- Projects Dashboard
src/routes/index.tsx - Project Workspace
src/routes/projects.$id.tsx - File Data Client
src/lib/use-file-data.ts
Analysis Artifacts
- FSD Analysis
src/components/fsd - API Specs
src/components/spec - ERD Studio
src/components/erd - Tasks and Phases
src/components/tasks/TasksView.tsx - SIT Test Cases
src/components/sit - Traceability Matrix
src/components/rtm - Canvas Sketches
src/components/canvas - Technical Docs
src/routes/projects.$id.docs.tsx - Project Wiki
src/components/wiki - Timeline Viewer
src/components/tasks/TimelineViewer.tsx
Agent Execution
- CLI Agent Engine
src/server/agent - Agent CLI Runtimes
src/server/agent/cli - Agent Terminal
src/server/terminal/terminal-server.ts
Server and State
- Task Routes
src/server/routes/projects/tasks.ts - Task File Parser
src/lib/task-parser.ts - Project Files
src/lib/file-router.ts - Design Link Browser
src/server/browser/manager.ts - Web Server
src/server.ts - API Router
src/server/api-router.ts - SQLite Database
src/server/db/client.ts - Data Schema
src/server/db/schema.ts - File Event Stream
src/lib/event-stream.ts
Desktop Shell
- Tauri Desktop Shell
src-tauri/src/lib.rs - Landing Content
landing/src/content.ts - Landing Changelog
landing/src/lib/use-changelog.ts - Landing Tracking
landing/src/track.ts
Other components
- System Analyst
Connections 28
- System Analyst → Projects Dashboard: opens project
README.md - Projects Dashboard → Project Workspace: opens
README.md - Project Workspace → FSD Analysis: edits FSD
README.md - FSD Analysis → CLI Agent Engine: starts analysis
README.md - CLI Agent Engine → Agent CLI Runtimes: dispatches to
README.md - CLI Agent Engine → API Specs: generates
README.md - CLI Agent Engine → ERD Studio: generates
README.md - CLI Agent Engine → Tasks and Phases: generates
README.md - CLI Agent Engine → SIT Test Cases: generates
README.md - CLI Agent Engine → Traceability Matrix: generates
README.md - CLI Agent Engine → Canvas Sketches: generates
README.md - CLI Agent Engine → Technical Docs: generates
README.md - Project Workspace → Project Wiki: opens
README.md - Project Workspace → Timeline Viewer: views
README.md - Project Workspace → Design Link Browser: captures design links
src/server/browser/manager.ts - Tasks and Phases → Task Routes: manages tasks
- Tasks and Phases → Task File Parser: uses task details
src/components/tasks/TasksView.tsx - Task Routes → Task File Parser: rewrites task sections
src/server/routes/projects/tasks.ts - Task Routes → Project Files: reads and writes
src/server/routes/projects/tasks.ts - Task Routes → SQLite Database: persists task state
src/server/routes/projects/tasks.ts - Web Server → API Router: handles requests
src/server.ts - Web Server → SQLite Database: initializes
src/server.ts - Web Server → Agent Terminal: starts terminal
src/server.ts - SQLite Database → Data Schema: uses schema
src/server/db/client.ts - File Data Client → File Event Stream: subscribes to
src/lib/use-file-data.ts - Tauri Desktop Shell → Web Server: hosts sidecar
README.md - Landing Content → Landing Changelog: provides content
- Landing Changelog → Landing Tracking: reports events