> 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/logs/readme_logs.md).

# Logs

The `logs/` directory is for private local diagnostics written by AI OS scripts and the development server.

## Generated Files

Common generated files include:

* `aggregate-*.jsonl` - timestamped aggregate traces.
* `aggregate.latest.jsonl` - latest aggregate trace pointer.
* `app.YYYY-MM-DD*.log` - local app logger output.

These files can include local runtime details, source readiness diagnostics, sanitized provider metadata, private paths, and machine-specific state. They are ignored by git and should not be committed.

## Tracked Files

Only this README is intended to be tracked from `logs/`. The root `.gitignore` keeps generated log output ignored while allowing `README_logs.md` to exist in the repository.

## Usage

Use log files for local debugging after commands such as:

```bash
bun run aggregate
bun run dev
```

Do not paste raw log contents into public docs, commits, PRs, or issue reports. Summarize relevant safe labels instead.


---

# 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/logs/readme_logs.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.