> 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/src/readme_src.md).

# Source

The `src/` directory contains the React/TanStack application for AI OS. Some modules still reflect the imported Claude OS starter foundation where compatibility contracts have not been renamed yet.

## Structure

| Path             | Purpose                                                     |
| ---------------- | ----------------------------------------------------------- |
| `assets/`        | Images and logos                                            |
| `components/`    | Shared app components                                       |
| `components/ui/` | Local UI primitive wrappers                                 |
| `data/`          | Runtime data shape and generated local JSON                 |
| `extensions/`    | Client extension contracts, registry, and extension modules |
| `hooks/`         | React hooks                                                 |
| `lib/`           | Utilities, data loading, error handling, and calculations   |
| `routes/`        | TanStack Router route files                                 |
| `router.tsx`     | Router factory                                              |
| `server.ts`      | Server entry wrapper                                        |
| `start.ts`       | TanStack Start instance                                     |
| `styles.css`     | Global styles                                               |

## Current Product State

The app uses AI OS product language in the visible host shell and route metadata while preserving inherited local-operator pages for skills, memory, activity, workspaces, setup, share, settings, and agent surfaces. Trend Finder product language lives in the Trend Finder extension. Some internal identifiers and environment variables still carry `claude-os` naming for compatibility and should be renamed only through a deliberate migration.

The `extensions/` directory holds the compile-time extension platform. See [Extension Architecture](/ai-os-and-trend-finder-docs/src/extensions/readme_extensions.md) for contracts and layout.


---

# 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/src/readme_src.md?ask=<question>&goal=<endgoal>
```

`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.