@aitne-sh/aitne 0.1.8 → 0.1.9

package/agent-assets/docs/getting-started/01-what-is-this.md

@@ -12,14 +12,15 @@ aliases:
 category: getting-started
 summary: |
   Aitne is a local-first proactive personal AI agent. It runs
-  as a daemon on your own machine, calls Claude / Codex / Gemini via
-  API keys you register (with the local CLI's subscription auth as a
-  fallback), and stores all memory as plain Markdown files.
+  as a daemon on your own machine, drives Claude / Codex / Gemini /
+  OpenCode via API keys you register (with the local CLI's
+  subscription auth as a fallback), and stores all memory as plain
+  Markdown files.
 section: getting-started
 tags:
   - core
   - getting-started
-  - overview
+  - backends
 status: stable
 ask_examples:
   - What is Aitne?
@@ -28,6 +29,9 @@ ask_examples:
   - What can Aitne actually do for me?
   - Which backends can Aitne drive?
 locale: en-US
+ui_anchors:
+  - /
+  - /settings/models
 keywords:
   - introduction
   - overview
@@ -38,7 +42,12 @@ keywords:
   - markdown memory
   - backends
 created: 2026-04-25
-updated: 2026-05-15
+updated: 2026-05-28
+context_files:
+  - state/today.md
+  - plans/roadmap.md
+  - journal/agent.md
+  - identity/profile.md
 related:
   - getting-started/02-first-steps
   - getting-started/03-what-can-this-do
@@ -69,7 +78,7 @@ By default:
 
 - Every morning, it reads your calendar, unread mail, open tasks, and
   recent notes, and writes today's plan into
-  [`today.md`](../features/memory-files/today.md).
+  [`state/today.md`](../features/memory-files/today.md).
 - Every evening, it reviews how the day went and updates
   [`journal.md`](../features/memory-files/agent-journal.md).
 - Once a week and once a month, it rolls those journals up.
@@ -117,9 +126,8 @@ decides what (if anything) is worth telling you about.
   [reading list](../features/lifestyle/reading.md),
   [receipts](../features/lifestyle/receipts.md), and
   [travel bookings](../features/lifestyle/travel-bookings.md).
-- [Calendar](../features/integrations/calendar.md) — including
-  [travel-time](../features/lifestyle/travel-time.md) lookups before
-  events.
+- [Calendar](../features/integrations/calendar.md) — pre-meeting
+  nudges and same-day briefing context.
 - [Obsidian](../features/integrations/obsidian.md) — watches a vault
   for new notes.
 - [Notion](../features/integrations/notion.md) — watches selected
@@ -134,16 +142,16 @@ Everything the agent learns about you is written as Markdown files
 you can read, edit, and version yourself. Nothing important lives in
 an opaque vector store.
 
-- [`user/profile.md`](../features/memory-files/user-profile.md) —
+- [`identity/profile.md`](../features/memory-files/user-profile.md) —
   what the agent knows about you.
-- [`projects/*.md`](../features/memory-files/projects.md) — one file
+- [`plans/projects/*.md`](../features/memory-files/projects.md) — one file
   per active project.
-- [`roadmap.md`](../features/memory-files/roadmap.md) — longer-term
+- [`plans/roadmap.md`](../features/memory-files/roadmap.md) — longer-term
   goals.
-- [`schedule/YYYY-MM-DD.md`](../features/memory-files/schedule.md) —
-  per-day plans.
-- [`today.md`](../features/memory-files/today.md) — today's plan.
-- [`agent/journal.md`](../features/memory-files/agent-journal.md) —
+- [`state/today.md`](../features/memory-files/today.md) — today's plan.
+- [`journal/daily/YYYY-MM-DD.md`](../features/memory-files/schedule.md) —
+  per-day archived plans.
+- [`journal/agent.md`](../features/memory-files/agent-journal.md) —
   what the agent did and noticed.
 
 → [Memory Model](../concepts/memory-model.md)
@@ -167,13 +175,16 @@ If you skip the API key, Aitne falls back to whatever local
 subscription login the CLI already has on your machine (`claude`,
 `codex login`, `gemini auth`). This fallback works mechanically, but
 most providers do not officially support running automated agents on
-a personal subscription — Anthropic currently prohibits using the
-Claude Agent SDK with a Claude Pro / Max subscription. The dashboard
-surfaces a warning whenever a backend is running on subscription
-auth.
-
-Each kind of work (heavy reasoning vs. a quick reply) is mapped to a
-backend; you can change the mapping any time.
+a personal subscription — Anthropic, for example, currently prohibits
+using the Claude Agent SDK with a Claude Pro / Max subscription. The
+dashboard surfaces a warning whenever a backend is running on
+subscription auth.
+
+Each kind of work is mapped to a backend and a tier — most work runs
+on medium (Claude Sonnet 4.6 by default) and quick triage on lite
+(Claude Haiku 4.5). The high tier (Claude Opus 4.8) is registered but
+left unseeded; you opt into it per task from the dashboard. You can
+change any of this mapping at any time.
 
 → [Backends and Tiers](../concepts/backends-and-tiers.md) ·
 [Costs and Quotas](../concepts/costs-and-quotas.md) ·

package/agent-assets/docs/getting-started/02-first-steps.md

@@ -31,12 +31,18 @@ keywords:
   - dashboard onboarding
   - health pill
 created: 2026-04-27
-updated: 2026-05-15
+updated: 2026-05-28
 related:
   - getting-started/01-what-is-this
   - getting-started/03-what-can-this-do
   - getting-started/04-first-day
   - guides/setup-wizard
+ui_anchors:
+  - /setup
+  - /
+  - /activity
+  - /connections
+  - /settings/models
 ---
 
 # First Steps in the Dashboard
@@ -63,9 +69,9 @@ in (a backend, a messaging pair). Run through it once, top to bottom.
    [Messaging Overview](../features/messaging/overview.md) for the
    list of supported apps and what each one does well.
 3. **Pick a main backend and register an API key.** Pick the LLM
-   the agent uses for "think hard" turns (Claude / Codex / Gemini)
-   and paste a provider API key — the supported way to run a
-   headless agent. If you skip the key, the daemon falls back to
+   the agent uses for "think hard" turns (Claude / Codex / Gemini /
+   OpenCode) and paste a provider API key — the supported way to run
+   a headless agent. If you skip the key, the daemon falls back to
    whatever subscription login the matching CLI already has on your
    machine; the dashboard surfaces a warning when this happens
    because most providers do not support running agents on a
@@ -73,10 +79,9 @@ in (a backend, a messaging pair). Run through it once, top to bottom.
    backend at a cloud provider (Bedrock / Vertex / Foundry / Azure
    OpenAI / Gemini-Vertex) instead of the direct API key — the
    provider dropdown on `/settings/models` is the single surface for
-   both direct keys and cloud-provider credentials.
-   Defaults are sensible and can be changed later from
-   `/settings/models`. Background:
-   [Backends and Tiers](../concepts/backends-and-tiers.md).
+   both direct keys and cloud-provider credentials. Defaults are
+   sensible and can be changed later from `/settings/models`.
+   Background: [Backends and Tiers](../concepts/backends-and-tiers.md).
 4. **Skip integrations you do not need yet.** Mail, calendar, git,
    Notion, Obsidian are all optional and re-runnable any time from
    `/connections`.

package/agent-assets/docs/getting-started/03-what-can-this-do.md

@@ -16,7 +16,9 @@ section: getting-started
 tags:
   - core
   - getting-started
-  - overview
+  - routines
+  - messaging
+  - wiki
 status: stable
 ask_examples:
   - What can Aitne actually do?
@@ -33,16 +35,23 @@ keywords:
   - wiki
   - lifestyle
 created: 2026-04-27
-updated: 2026-05-15
+updated: 2026-05-28
 related:
   - getting-started/01-what-is-this
   - getting-started/02-first-steps
   - getting-started/04-first-day
   - concepts/routines
   - concepts/memory-model
+  - concepts/skills
   - features/messaging/overview
   - features/wiki/overview
   - features/wiki/commands
+ui_anchors:
+  - /chat
+  - /connections/messaging
+  - /knowledge
+  - /wiki
+  - /settings/self-learning
 ---
 
 # What This App Can Do
@@ -53,7 +62,7 @@ the doc that goes deep.
 ## Plan your day, on its own
 
 The agent runs **routines** on a schedule. The morning routine builds
-`today.md` from your calendar, mail, tasks, and notes; the evening
+`state/today.md` from your calendar, mail, tasks, and notes; the evening
 review writes a journal entry; the weekly review rolls up the week.
 
 - [Routines](../concepts/routines.md) — what runs and when.
@@ -93,10 +102,10 @@ them — the agent reads what's there next time it runs.
 
 - [Memory Model](../concepts/memory-model.md) — the layout and the
   rules around it.
-- [user/profile.md](../features/memory-files/user-profile.md) — what
+- [identity/profile.md](../features/memory-files/user-profile.md) — what
   the agent knows about you.
-- [today.md](../features/memory-files/today.md) — today's plan.
-- [agent/journal.md](../features/memory-files/agent-journal.md) —
+- [state/today.md](../features/memory-files/today.md) — today's plan.
+- [journal/agent.md](../features/memory-files/agent-journal.md) —
   what the agent did and what it noticed.
 
 ## Build a personal wiki from what you DM
@@ -117,13 +126,12 @@ API so the layout invariants hold.
 
 ## Help with the small lifestyle stuff
 
-Reading lists, receipts, travel bookings, travel-time estimates — the
-agent collects what arrives in mail and surfaces it in the right tab.
+Reading lists, receipts, travel bookings — the agent collects what
+arrives in mail and surfaces it in the right tab.
 
 - [Reading](../features/lifestyle/reading.md)
 - [Receipts](../features/lifestyle/receipts.md)
 - [Travel Bookings](../features/lifestyle/travel-bookings.md)
-- [Travel Time](../features/lifestyle/travel-time.md)
 
 ## Stay in control
 
@@ -139,11 +147,14 @@ operations keep the agent from doing anything you don't want.
 
 ## Get sharper over time
 
-A background self-optimization loop watches how your knowledge layout
-drifts (new folders, schema tweaks, vocabulary changes) and refines
-specific skill sections to match. The original SKILL.md files are
-never rewritten — overlays are reversible. The loop runs as a daemon
-observer; you can review its proposals from the dashboard.
+A background skill-curation loop watches how your knowledge layout
+drifts (new folders, schema tweaks, vocabulary changes) and proposes
+JSON **overlays** that refine specific skill sections to match. The
+seed `SKILL.md` files are never rewritten — overlays are reversible.
+Review and approve proposals from **Settings → Self-learning**.
+
+- [Skills](../concepts/skills.md) — how skill curation, overlays, and
+  the self-learning review surface work.
 
 ## Related
 

package/agent-assets/docs/getting-started/04-first-day.md

@@ -18,6 +18,9 @@ tags:
   - core
   - getting-started
   - setup
+  - integrations
+  - routines
+  - memory
 status: stable
 keywords:
   - first day
@@ -35,8 +38,21 @@ ask_examples:
   - How do I connect an app that isn't on the integrations list?
   - Can I teach the agent a multi-step morning task?
 locale: en-US
+ui_anchors:
+  - /knowledge?tab=upload
+  - /knowledge?tab=context-files
+  - /connections
+  - /connections/mcp
+  - /settings/routines
+  - /activity
+context_files:
+  - identity/profile.md
+  - state/today.md
+  - journal/agent.md
+api_endpoints:
+  - POST /api/knowledge/import
 created: 2026-04-25
-updated: 2026-04-27
+updated: 2026-05-28
 related:
   - getting-started/02-first-steps
   - getting-started/03-what-can-this-do
@@ -84,8 +100,8 @@ and 2.
 ## 1. Teach the agent about you
 
 The agent reads
-[`user/profile.md`](../features/memory-files/user-profile.md) and
-the rest of the `user/*.md` Context Files at the start of every
+[`identity/profile.md`](../features/memory-files/user-profile.md) and
+the rest of the `identity/*.md` Context Files at the start of every
 session. The faster those files have real content, the faster every
 reply gets useful.
 
@@ -101,9 +117,9 @@ Send 3–5 DMs that read like introductions to a new assistant:
 - *"I prefer terse replies in English. Don't summarize what I just
   said back to me."*
 
-The agent appends each fact to the right `user/*.md` file (work
-facts → `user/work.md`, people → `user/people.md`, preferences →
-`user/personal.md`, and so on). Identity-class facts (legal name,
+The agent appends each fact to the right `identity/*.md` file (work
+facts → `identity/work.md`, people → `identity/people.md`, preferences →
+`identity/personal.md`, and so on). Identity-class facts (legal name,
 primary timezone) are deferred for your explicit confirmation
 rather than auto-written.
 
@@ -125,13 +141,13 @@ second upload are skipped automatically.
 
 ### Verify what landed
 
-Open **Knowledge → Context Files** and skim each `user/*.md` file.
+Open **Knowledge → Context Files** and skim each `identity/*.md` file.
 If a bullet is wrong, edit it directly — the agent reads your edit
 on its next turn. The journal entry the import session writes
-(`agent/journal.md`) lists everything that was deferred or flagged
+(`journal/agent.md`) lists everything that was deferred or flagged
 as a conflict.
 
-→ [user/profile.md](../features/memory-files/user-profile.md) ·
+→ [identity/profile.md](../features/memory-files/user-profile.md) ·
 [Memory Model](../concepts/memory-model.md)
 
 ---
@@ -148,7 +164,7 @@ Open **Connections** and connect the ones you live in:
 | Integration | What it gives the agent |
 |---|---|
 | [Mail](../features/integrations/mail.md) | Reads and locally searches your inbox (Gmail, Outlook, Yahoo, iCloud, IMAP). Auto-files reading lists, receipts, travel bookings. |
-| [Calendar](../features/integrations/calendar.md) | Sees today's and upcoming events. Pre-meeting nudges, plus travel-time lookups. |
+| [Calendar](../features/integrations/calendar.md) | Sees today's and upcoming events. Pre-meeting nudges. |
 | [Obsidian](../features/integrations/obsidian.md) | Watches a vault for new notes — references them in the morning plan. |
 | [Notion](../features/integrations/notion.md) | Watches selected pages and databases for changes. |
 | [Git](../features/integrations/git.md) / [GitHub](../features/integrations/github.md) | Watches local repos and tracked GitHub repos. |
@@ -253,14 +269,16 @@ Shortest path from zero to that:
    → Add custom routine**:
    - Slug: `morning-deep-prep`
    - Cron: `0 7 * * 1-5`
-   - Backend tier: `heavy`
-   - Max budget USD: `0.20`
+   - Backend tier: `high (opus)` — this is a heavy, multi-tool job
+   - Max budget (USD): `0.20` (a generous per-execute override; the
+     form default is `0.05`)
    - Description: paste the four numbered steps above verbatim.
 3. **Watch the next firing in Activity** and iterate. The vault file
-   at `~/.personal-agent/context/routines/custom/morning-deep-prep.md`
-   is a plain Markdown file — edit the `## Checks` section directly
-   to refine the wording or change the schedule. The watcher picks
-   up changes without a restart.
+   at `~/.personal-agent/context/policies/routines/custom/morning-deep-prep.md`
+   is a plain Markdown file: edit the `## Checks` body to refine the
+   step wording, or the `cron:` field in the YAML frontmatter to
+   change the schedule. The watcher picks up changes without a
+   restart.
 
 → [Custom Routines](../features/routines/custom-routines.md) ·
 [Add a Custom Routine](../guides/add-a-custom-routine.md)
@@ -271,7 +289,7 @@ Shortest path from zero to that:
 
 By end of day one you should have:
 
-- At least 5–10 facts in `user/*.md` (DM and/or upload).
+- At least 5–10 facts in `identity/*.md` (DM and/or upload).
 - Two or more **Connections** connected and showing recent polls in
   **Activity**.
 - One DM whose answer references something only your connected
@@ -281,11 +299,11 @@ By end of day one you should have:
 
 ## If it fails
 
-- Replies never reference anything specific to you → `user/*.md` is
+- Replies never reference anything specific to you → `identity/*.md` is
   still mostly empty. DM more, or run a Knowledge upload.
 - A connected integration shows no observations after an hour →
   [Observation Not Detected](../troubleshooting/observation-not-detected.md).
-- A blank `today.md` after the morning routine →
+- A blank `state/today.md` after the morning routine →
   [Morning Routine Didn't Run](../troubleshooting/morning-routine-didnt-run.md).
 - A Knowledge upload returns `409 setup_incomplete` → finish the
   setup wizard at `/setup` first.
@@ -298,4 +316,4 @@ By end of day one you should have:
 - [Add a Custom Routine](../guides/add-a-custom-routine.md)
 - [Delegated Mode](../concepts/delegated-mode.md)
 - [Skills and MCP](../concepts/skills.md)
-- [user/profile.md](../features/memory-files/user-profile.md)
+- [identity/profile.md](../features/memory-files/user-profile.md)