@aitne-sh/aitne 0.1.12 → 0.1.13

package/agent-assets/docs/pages/agents.md

@@ -0,0 +1,78 @@
+---
+schema_version: 1
+slug: pages/agents
+title: "Agents Page"
+id: page-agents
+aliases:
+  - agents page
+  - agents hub
+  - routines page
+category: pages
+summary: |
+  The Agents page is the hub for everything that runs on your behalf — the
+  shipped System routines and your own User Agents. Each has a schedule, a
+  rulebook, limits, and recent health you can review and edit here.
+tags:
+  - agents
+  - routines
+  - autonomous
+status: stable
+ask_examples:
+  - What can I do on the Agents page?
+  - How do I create a new agent?
+  - Where do I edit a routine's rulebook or schedule?
+  - How do I see how often an agent fails?
+locale: en-US
+created: 2026-07-01
+updated: 2026-07-01
+keywords:
+  - agents
+  - routines
+  - schedule
+  - rulebook
+  - system agents
+related:
+  - pages/tasks
+  - concepts/routines
+  - features/routines/morning-routine
+  - features/routines/custom-routines
+ui_anchors:
+  - /agents
+---
+
+# Agents Page
+
+The `/agents` page lists each automation as its own named thing you can
+open and edit — not as a one-off item waiting in a line. **System** agents
+are the routines that ship with the app (synthesis, monitoring,
+maintenance); **User** agents are the ones you create yourself.
+
+## What you can do here
+
+- **Browse, search, and filter** every agent, grouped by System vs. User.
+- **Check health at a glance** — last run time and 7-day error rate sit on
+  each card.
+- **Create a new Agent** with the **New Agent** button (name, schedule,
+  rulebook, and limits).
+- **Open an agent** to edit its rulebook and journal rules, adjust its
+  schedule window and cost/turn limits, and read recent executions.
+- **Stop a System agent** (they can't be deleted) or fully manage your own
+  User agents.
+
+What is about to run next lives on the [Tasks](../pages/tasks.md) queue,
+not here.
+
+## Where to go deeper
+
+- [Routines](../concepts/routines.md) — what runs, when, and why.
+- [Morning Routine](../features/routines/morning-routine.md) ·
+  [Evening Review](../features/routines/evening-review.md) ·
+  [Weekly Review](../features/routines/weekly-review.md) ·
+  [Activity Scan](../features/routines/activity-scan.md) — the built-ins.
+- [Custom routines](../features/routines/custom-routines.md) — authoring
+  your own User agents.
+
+## Related
+
+- [Tasks page](tasks.md) — the run queue and scheduled DMs.
+- [Settings page](settings.md) — global hours and notification policy.

package/agent-assets/docs/pages/analytics.md

@@ -0,0 +1,70 @@
+---
+schema_version: 1
+slug: pages/analytics
+title: "Analytics Page"
+id: page-analytics
+aliases:
+  - analytics page
+  - cost page
+  - metrics page
+category: pages
+summary: |
+  The Analytics page shows usage and spend trends — Cost aggregates
+  per-run USD by backend and process across days, weeks, and months;
+  Metrics shows operational health like activity volume and error rates.
+  All from the local database, nothing sent externally.
+tags:
+  - cost
+status: stable
+ask_examples:
+  - What can I do on the Analytics page?
+  - Where do I see how much the agent is spending?
+  - How do I check the agent's error rate?
+  - Is my usage data sent anywhere?
+locale: en-US
+created: 2026-07-01
+updated: 2026-07-01
+keywords:
+  - analytics
+  - cost
+  - spend
+  - metrics
+  - error rate
+related:
+  - concepts/costs-and-quotas
+  - features/operations/cost-tracking
+  - features/operations/backend-routing
+  - pages/activity
+ui_anchors:
+  - /analytics
+---
+
+# Analytics Page
+
+The `/analytics` page takes the raw event log and turns it into usage and
+spend trends, laid out across two tabs.
+
+## What you can do here
+
+- **Cost tab** — per-run USD spend (token counts × backend pricing),
+  totaled by day, week, and month and split out by backend and process.
+  This is where you answer "what is this costing me, and where."
+- **Metrics tab** — how the agent is running: activity volume, a breakdown
+  of what ran, error rates, and how many notifications went out.
+
+All figures come from the daemon's local SQLite database — nothing is sent
+to any external service.
+
+## Where to go deeper
+
+- [Costs & quotas](../concepts/costs-and-quotas.md) — how spend and
+  budgets work.
+- [Cost tracking](../features/operations/cost-tracking.md) — how per-run
+  cost is computed and attributed.
+- [Backend routing](../features/operations/backend-routing.md) — why one
+  backend costs more than another.
+
+## Related
+
+- [Agent Log page](activity.md) — the per-event detail behind these totals.
+- [Settings → Models](settings.md) — change which model handles which tier.

package/agent-assets/docs/pages/browser.md

@@ -0,0 +1,73 @@
+---
+schema_version: 1
+slug: pages/browser
+title: "Browser Page"
+id: page-browser
+aliases:
+  - browser page
+  - browser hub
+category: pages
+summary: |
+  The Browser page is the home for everything the agent does with a
+  browser: reading your existing Chrome history, driving a dedicated
+  sandboxed Chromium, the experimental purchase-confirmation flow, and the
+  browser tasks it has run.
+tags:
+  - autonomous
+status: stable
+ask_examples:
+  - What can I do on the Browser page?
+  - How do I let the agent read my browsing history?
+  - Where do I see browser tasks the agent ran?
+  - What is the managed Chromium for?
+locale: en-US
+created: 2026-07-01
+updated: 2026-07-01
+keywords:
+  - browser
+  - chromium
+  - browsing history
+  - automation
+  - browser tasks
+related:
+  - features/operations/managed-chromium
+  - features/operations/browser-tasks
+  - features/integrations/browser-history
+ui_anchors:
+  - /browser
+  - /browser-tasks
+---
+
+# Browser Page
+
+The `/browser` page brings every browser feature together in one place.
+Each one has its own on/off switch and settings.
+
+## What you can do here
+
+- **Browser History** — let the agent read your existing Chrome history so
+  it can build research clusters and add revisit nudges to the morning
+  digest.
+- **Browser Automation** — set up the dedicated, sandboxed Chromium (a
+  separate, isolated browser) that the agent drives for sign-in (OAuth)
+  sites and task slots. A hostname denylist limits which sites it may open.
+- **Purchase Confirmations** — the experimental B-4 flow. Before the agent
+  can go through with a purchase, it must use a single-use token that is
+  sent to you by DM. This is off by default.
+- **Browser tasks** — review the tasks the agent has run, including any
+  waiting for your confirmation, one click away at `/browser-tasks`.
+
+## Where to go deeper
+
+- [Managed Chromium](../features/operations/managed-chromium.md) — the
+  sandboxed browser the agent drives.
+- [Browser tasks](../features/operations/browser-tasks.md) — how a browser
+  task is requested, run, and confirmed.
+- [Browser history](../features/integrations/browser-history.md) — reading
+  from your existing Chrome.
+
+## Related
+
+- [Connections page](connections.md) — where other integrations are linked.
+- [Settings page](settings.md) — Browser History and Automation also have
+  settings panels.

package/agent-assets/docs/pages/chat.md

@@ -0,0 +1,67 @@
+---
+schema_version: 1
+slug: pages/chat
+title: "Chat Page"
+id: page-chat
+aliases:
+  - chat page
+  - dashboard chat page
+category: pages
+summary: |
+  The Chat page is an in-dashboard conversation with your agent — the same
+  agent you reach from Telegram, Slack, Discord, and WhatsApp, just from a
+  browser tab. Send messages, run bang commands, and revisit past sessions.
+tags:
+  - messaging
+status: stable
+ask_examples:
+  - What can I do on the Chat page?
+  - Can I talk to the agent from the dashboard?
+  - Do bang commands work in the dashboard chat?
+  - Where do I find an old chat session?
+locale: en-US
+created: 2026-07-01
+updated: 2026-07-01
+keywords:
+  - chat
+  - conversation
+  - messaging
+  - dashboard chat
+related:
+  - features/messaging/dashboard-chat
+  - features/messaging/overview
+  - features/messaging/bang-commands
+ui_anchors:
+  - /chat
+---
+
+# Chat Page
+
+The `/chat` page lets you talk to your agent right inside the dashboard.
+It uses the same agent, memory, and tools as the messaging apps — so
+anything you could send the agent in a DM, you can type here.
+
+## What you can do here
+
+- **Message the agent.** Ask questions, give instructions, or follow up on
+  something it did. Replies stream back word by word, in real time.
+- **Run bang commands.** `!help`, `!ingest`, `!compile`, `!ask`, and the
+  rest work exactly as they do on messaging apps.
+- **Revisit past sessions.** Switch to an earlier conversation to re-read
+  what was said; completed threads are also visible under
+  [Agent Log → Conversations](activity.md).
+
+## Where to go deeper
+
+- [Dashboard Chat](../features/messaging/dashboard-chat.md) — the Chat
+  page in detail.
+- [Messaging Overview](../features/messaging/overview.md) — the same agent
+  from Telegram, Slack, Discord, and WhatsApp, plus how pairing and voice
+  notes work.
+- [Bang commands](../features/messaging/bang-commands.md) — the full `!`
+  command reference.
+
+## Related
+
+- [Agent Log page](activity.md) — where completed conversations are archived.
+- [Connections page](connections.md) — link the messaging apps.

package/agent-assets/docs/pages/connections.md

@@ -0,0 +1,78 @@
+---
+schema_version: 1
+slug: pages/connections
+title: "Connections Page"
+id: page-connections
+aliases:
+  - connections page
+  - integrations page
+  - connections hub
+category: pages
+summary: |
+  The Connections page is the hub for linking outside services to the
+  agent — messaging apps, git repositories, note sources (Obsidian and
+  Notion), calendar, mail, and MCP servers. Each has its own sub-page.
+tags:
+  - integrations
+status: stable
+ask_examples:
+  - What can I do on the Connections page?
+  - How do I connect my calendar or mail?
+  - Where do I link Obsidian or Notion?
+  - How do I add an MCP server?
+locale: en-US
+created: 2026-07-01
+updated: 2026-07-01
+keywords:
+  - connections
+  - integrations
+  - messaging
+  - calendar
+  - mail
+  - mcp
+related:
+  - features/messaging/overview
+  - features/integrations/calendar
+  - features/integrations/mail
+  - concepts/skills
+ui_anchors:
+  - /connections
+---
+
+# Connections Page
+
+The Connections area is where you connect outside services — your chat
+apps, calendar, notes, and more — to the agent. It opens on the
+**Messaging** tab, and a sidebar on the left switches between the
+connection types.
+
+## What you can do here
+
+- **Messaging** (`/connections/messaging`) — pair Telegram, Slack, Discord,
+  and WhatsApp so you can DM the agent.
+- **Repositories** (`/connections/repositories`) — register git repos to
+  watch (then tune them on the [Git page](../pages/git.md)).
+- **Notes** (`/connections/notes`) — connect your personal Obsidian vault
+  and Notion.
+- **Calendar** (`/connections/calendar`) — link Google Calendar.
+- **Mail** (`/connections/mail`) — connect a mail account.
+- **MCP Servers** (`/connections/mcp`) — attach Model Context Protocol
+  servers that give the agent more tools.
+
+## Where to go deeper
+
+- [Messaging Overview](../features/messaging/overview.md) — supported apps
+  and pairing.
+- [Calendar](../features/integrations/calendar.md) ·
+  [Mail](../features/integrations/mail.md) ·
+  [Git](../features/integrations/git.md) ·
+  [Obsidian](../features/integrations/obsidian.md) ·
+  [Notion](../features/integrations/notion.md) — per-integration detail.
+- [Skills](../concepts/skills.md) — how MCP servers expand what the agent
+  can do.
+
+## Related
+
+- [Git page](git.md) — configure repositories after registering them here.
+- [Settings page](settings.md) — the agent's own primary vault is managed
+  from Settings → Management.

package/agent-assets/docs/pages/git.md

@@ -0,0 +1,73 @@
+---
+schema_version: 1
+slug: pages/git
+title: "Git Page"
+id: page-git
+aliases:
+  - git page
+  - repositories page
+category: pages
+summary: |
+  The Git page configures how the agent watches each registered
+  repository — polling cadence, automation triggers, and the daily git
+  management the morning routine performs. Repositories are registered on
+  the Connections page.
+tags:
+  - git
+  - lifestyle
+status: stable
+ask_examples:
+  - What can I do on the Git page?
+  - How do I change how often the agent checks a repo?
+  - Where do I set up automation triggers for a repository?
+  - How do I add a repository?
+locale: en-US
+created: 2026-07-01
+updated: 2026-07-01
+keywords:
+  - git
+  - repositories
+  - polling
+  - triggers
+  - daily management
+related:
+  - features/lifestyle/git
+  - features/integrations/git
+  - features/integrations/github
+ui_anchors:
+  - /git
+---
+
+# Git Page
+
+The `/git` page is where you fine-tune how the agent handles each
+repository you've registered. Every registered repo shows three
+collapsible sections.
+
+## What you can do here
+
+- **Polling** — how often the agent checks the repo for changes.
+- **Triggers** — automation rules that start follow-up work when a change
+  matches a rule you set.
+- **Daily git management** — the routine upkeep the morning routine runs
+  on the repo each day.
+
+You add repositories on the Connections page
+(`/connections/repositories`), not here. If you haven't registered any
+yet, this page just shows a "No repositories registered" prompt that links
+you there.
+
+## Where to go deeper
+
+- [Git (lifestyle)](../features/lifestyle/git.md) — how the agent watches
+  and reports on your repos.
+- [Git integration](../features/integrations/git.md) — registering and
+  authenticating repositories.
+- [GitHub integration](../features/integrations/github.md) — the GitHub
+  side (PRs, issues).
+
+## Related
+
+- [Connections page](connections.md) — register repositories here first.
+- [Agents page](agents.md) — the morning routine that runs daily git
+  management.

package/agent-assets/docs/pages/knowledge.md

@@ -0,0 +1,75 @@
+---
+schema_version: 1
+slug: pages/knowledge
+title: "Knowledge Page"
+id: page-knowledge
+aliases:
+  - knowledge page
+  - memory page
+  - context files page
+category: pages
+summary: |
+  The Knowledge page is where the agent's memory lives — the Markdown
+  context files it reads and writes, the skills it runs, plus activity,
+  entities, and a way to upload your own knowledge files.
+tags:
+  - knowledge
+  - memory
+  - skills
+status: stable
+ask_examples:
+  - What can I do on the Knowledge page?
+  - Where do I edit what the agent knows about me?
+  - Where are the agent's skills?
+  - How do I upload a file into the agent's knowledge?
+locale: en-US
+created: 2026-07-01
+updated: 2026-07-01
+keywords:
+  - knowledge
+  - memory
+  - context files
+  - skills
+  - entities
+  - upload
+related:
+  - concepts/memory-model
+  - concepts/skills
+  - features/memory-files/user-profile
+  - guides/import-knowledge-file
+ui_anchors:
+  - /knowledge
+---
+
+# Knowledge Page
+
+The `/knowledge` page is your window into the agent's memory and skills.
+It has five tabs.
+
+## What you can do here
+
+- **Context Files** — browse and edit the plain-Markdown files the agent
+  reads and writes (identity/profile, state/today, journals, and more).
+- **Skills** — review the skills the agent can run and how they're wired.
+- **Activity** — see recent reads and writes against the knowledge store.
+- **Entities** — the people, projects, and things the agent has extracted.
+- **Upload** — add your own file into the agent's knowledge.
+
+Tip: the `?` on each tab opens the concept doc for that tab specifically
+(memory model, skills, or the import guide).
+
+## Where to go deeper
+
+- [Memory model](../concepts/memory-model.md) — the file layout and the
+  rules around it.
+- [Skills](../concepts/skills.md) — how skills and the self-learning loop
+  work.
+- [User profile file](../features/memory-files/user-profile.md) — what the
+  agent knows about you.
+- [Import a knowledge file](../guides/import-knowledge-file.md) — the
+  upload flow end to end.
+
+## Related
+
+- [Wiki page](wiki.md) — a separate, workspace-scoped knowledge builder.
+- [Settings page](settings.md) — Self-learning and Management live there.

package/agent-assets/docs/pages/overview.md

@@ -0,0 +1,90 @@
+---
+schema_version: 1
+slug: pages/overview
+title: "Overview Page"
+id: page-overview
+aliases:
+  - overview page
+  - home page
+  - dashboard home
+  - landing page
+category: pages
+summary: |
+  The Overview is the dashboard home — your agent at a glance. It shows
+  current status, what needs your attention, today's activity and spend,
+  and shortcuts into the rest of the app.
+tags:
+  - dashboard
+status: stable
+ask_examples:
+  - What can I do on the Overview page?
+  - Where do I approve something the agent is waiting on?
+  - How do I trigger an activity scan right now?
+  - Where do I see today's cost on the dashboard?
+locale: en-US
+created: 2026-07-01
+updated: 2026-07-01
+keywords:
+  - overview
+  - home
+  - status
+  - approvals
+  - run now
+related:
+  - pages/activity
+  - pages/analytics
+  - concepts/agent-day
+  - features/operations/approvals
+  - features/operations/activity-and-conversations
+ui_anchors:
+  - /
+---
+
+# Overview Page
+
+The landing screen at `/`. It answers "is my agent OK, and does anything
+need me right now?" without making you dig through the other pages.
+
+## What you can do here
+
+- **See what needs attention.** System warnings and pending
+  [approvals](../features/operations/approvals.md) surface at the top and
+  can be approved or rejected inline. Both are hidden when there is
+  nothing to act on.
+- **Read the status bar.** Current agent state, the next scheduled
+  activity scan (with a **Run now** button to trigger it immediately),
+  and today's spend.
+- **Skim recent activity.** A live feed of the latest agent events — jump
+  to the [Agent Log](activity.md) for the full history.
+- **Glance at today's context.** Calendar preview, drafts awaiting your
+  review, a health summary, and a cost summary card.
+- **Jump into your life.** "Your Life" shortcuts and a rotating capability
+  tip link out to Knowledge, Wiki, Reading, and more.
+
+## Where to go deeper
+
+- [The agent's day](../concepts/agent-day.md) — how routines, scans, and
+  quiet hours shape what you see here.
+- [Approvals](../features/operations/approvals.md) — when the agent asks
+  before acting.
+- [Activity & Conversations](../features/operations/activity-and-conversations.md)
+  — the full audit trail behind the recent-events feed.
+- [Costs & quotas](../concepts/costs-and-quotas.md) — what the spend
+  numbers mean.
+
+## Related
+
+Every other dashboard page, all reachable from here:
+
+- [Chat page](chat.md)
+- [Agents page](agents.md)
+- [Tasks page](tasks.md)
+- [Agent Log page](activity.md)
+- [Analytics page](analytics.md)
+- [Knowledge page](knowledge.md)
+- [Wiki page](wiki.md)
+- [Reading page](reading.md)
+- [Browser page](browser.md)
+- [Git page](git.md)
+- [Connections page](connections.md)
+- [Settings page](settings.md)

package/agent-assets/docs/pages/reading.md

@@ -0,0 +1,65 @@
+---
+schema_version: 1
+slug: pages/reading
+title: "Reading Page"
+id: page-reading
+aliases:
+  - reading page
+  - books page
+  - highlights page
+category: pages
+summary: |
+  The Reading page is your reading list built from Kindle — import your
+  My Clippings.txt, then browse books (filterable by status) and the
+  highlights the agent extracted.
+tags:
+  - reading
+  - lifestyle
+status: stable
+ask_examples:
+  - What can I do on the Reading page?
+  - How do I import my Kindle highlights?
+  - Where do I see my book highlights?
+  - How do I filter books I've finished?
+locale: en-US
+created: 2026-07-01
+updated: 2026-07-01
+keywords:
+  - reading
+  - books
+  - highlights
+  - kindle
+  - clippings
+related:
+  - features/lifestyle/reading
+ui_anchors:
+  - /reading
+---
+
+# Reading Page
+
+The `/reading` page gathers your Kindle reading into one browsable
+list, split across two tabs.
+
+## What you can do here
+
+- **Import My Clippings.txt** with the button in the header (connect your
+  Kindle via OpenMTP or the Send-to-Kindle app first). After the first
+  upload, new highlights arrive on their own through the Kindle Notebook
+  Export email pipeline — Kindle emails your exported notes and the agent
+  imports them for you.
+- **Books tab** — every book, filterable by status (All, Reading,
+  Completed, Abandoned).
+- **Highlights tab** — the individual highlights extracted from your
+  clippings.
+
+## Where to go deeper
+
+- [Reading](../features/lifestyle/reading.md) — how the Kindle import and
+  highlight sync work, and how the agent uses them.
+
+## Related
+
+- [Knowledge page](knowledge.md) — where longer-lived notes live.
+- [Overview page](overview.md) — Reading is one of the "Your Life"
+  shortcuts.