> For the complete documentation index, see [llms.txt](https://ai-os-and-trend-finder.gitbook.io/ai-os-and-trend-finder-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ai-os-and-trend-finder.gitbook.io/ai-os-and-trend-finder-docs/.spec_system/archive/phases/phase_22/session_03_setup_wizard_dream_sources_strip.md). # Session 03: Setup Wizard And Dream Sources Strip **Session ID**: `phase22-session03-setup-wizard-dream-sources-strip` **Status**: Not Started **Estimated Tasks**: \~18-24 **Estimated Duration**: 3-4 hours *** ## Objective Add the Hermes Agent setup wizard card and port the v2.3 Dream source-status strip as a small aios home component backed by validated detection and Hermes data. *** ## Source Reference Detail ### B2 Hermes Card In Setup Wizard * v2.3 adds a "Hermes Agent" tool card with default path `~/.hermes/hermes-agent`: [V23/src/routes/setup.tsx:198](https://github.com/moshehbenavraham/ai-os/blob/main/home/aiwithapex/projects/claudeos/claude-os-v2.3/src/routes/setup.tsx:198) through `:207`. * v2.3 type/detection wiring: [V23/src/routes/setup.tsx:102](https://github.com/moshehbenavraham/ai-os/blob/main/home/aiwithapex/projects/claudeos/claude-os-v2.3/src/routes/setup.tsx:102), [V23/src/routes/setup.tsx:265](https://github.com/moshehbenavraham/ai-os/blob/main/home/aiwithapex/projects/claudeos/claude-os-v2.3/src/routes/setup.tsx:265), and [V23/src/routes/setup.tsx:326](https://github.com/moshehbenavraham/ai-os/blob/main/home/aiwithapex/projects/claudeos/claude-os-v2.3/src/routes/setup.tsx:326). * aios already exposes `hermes` in app detection: [AIOS/scripts/lib/app-detection.ts:63](https://github.com/moshehbenavraham/ai-os/blob/main/home/aiwithapex/projects/aios/scripts/lib/app-detection.ts:63). * aios setup card list lives in `AIOS/src/components/setup/constants.ts`; the route wiring is in `AIOS/src/routes/setup.tsx`. ### B3 DreamSourcesStrip * v2.3 defines `DreamSourcesStrip` and `DreamSourceTile`: [V23/src/routes/index.tsx:16278](https://github.com/moshehbenavraham/ai-os/blob/main/home/aiwithapex/projects/claudeos/claude-os-v2.3/src/routes/index.tsx:16278) through `:16542`. * v2.3 mounts the strip at: [V23/src/routes/index.tsx:16241](https://github.com/moshehbenavraham/ai-os/blob/main/home/aiwithapex/projects/claudeos/claude-os-v2.3/src/routes/index.tsx:16241). * The strip shows every feed Dream reads: Claude Code, Antigravity, Memory, Skills, Integrations, Automations, and Hermes, each with live, optional, or missing status. * aios currently has no equivalent in `AIOS/src/routes/index.tsx`. *** ## Scope ### In Scope (MVP) * Add a Hermes Agent tool-card constant with default path `~/.hermes/hermes-agent`. * Update setup route types and detection wiring so the card reflects existing `detection.apps.hermes` state. * Port `DreamSourcesStrip` into a focused aios component file. * Add a `home-transforms` selector or equivalent pure helper to derive the source tiles from `detection.apps`, local memory/skills/integration data, automation/scheduler data, and `hermes` data. * Include Claude Code, Antigravity, Memory, Skills, Integrations, Automations, and Hermes tiles. * Use live/optional/missing pills and safe counts/statuses only. * Add tests for fully live, partially missing, no Antigravity, no Hermes, and demo/example data states. ### Out of Scope * New Dream runtime behavior or scheduler changes. * Raw prompt, transcript, path, credential, or private automation details in the browser. * Depending on Hermes Phases 16-20 being complete; the tile must degrade safely from current data. *** ## Prerequisites * [ ] Phase 22 Session 01 complete for Antigravity tile data. * [ ] Confirm setup constants and route type conventions. * [ ] Confirm current home component extraction patterns before adding the strip. *** ## Deliverables 1. Hermes Agent setup wizard card backed by existing detection. 2. `DreamSourcesStrip` component and source-tile selector. 3. Home dashboard mount point for the strip. 4. Tests for setup card and source-tile derivation/rendering. *** ## Success Criteria * [ ] Setup wizard displays Hermes Agent with the planned default path and detection-driven state. * [ ] `DreamSourcesStrip` renders all seven source categories. * [ ] Tiles expose only safe labels, counts, and status pills. * [ ] Missing optional sources do not break the home dashboard. * [ ] Antigravity and Hermes tiles light up when their data exists and degrade when absent. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://ai-os-and-trend-finder.gitbook.io/ai-os-and-trend-finder-docs/.spec_system/archive/phases/phase_22/session_03_setup_wizard_dream_sources_strip.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.