@aitne-sh/aitne 0.1.12 → 0.1.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (139) hide show
  1. package/agent-assets/agent-profiles/background-task.md +8 -1
  2. package/agent-assets/agent-profiles/routine-fetch-window.md +11 -0
  3. package/agent-assets/agents/evening-review/agent.md +6 -2
  4. package/agent-assets/agents/lesson-maintenance/agent.md +56 -0
  5. package/agent-assets/agents/morning-routine/agent.md +7 -2
  6. package/agent-assets/agents/source-librarian/agent.md +51 -0
  7. package/agent-assets/docs/concepts/agent-day.md +15 -15
  8. package/agent-assets/docs/concepts/auth-health.md +10 -7
  9. package/agent-assets/docs/concepts/backends-and-tiers.md +21 -13
  10. package/agent-assets/docs/concepts/costs-and-quotas.md +10 -10
  11. package/agent-assets/docs/concepts/delegated-mode.md +18 -18
  12. package/agent-assets/docs/concepts/memory-model.md +25 -24
  13. package/agent-assets/docs/concepts/observations.md +27 -19
  14. package/agent-assets/docs/concepts/process-keys.md +25 -26
  15. package/agent-assets/docs/concepts/routines.md +18 -17
  16. package/agent-assets/docs/concepts/safety-and-execution.md +20 -17
  17. package/agent-assets/docs/concepts/safety-model.md +16 -15
  18. package/agent-assets/docs/concepts/skills.md +7 -4
  19. package/agent-assets/docs/features/integrations/browser-history.md +52 -47
  20. package/agent-assets/docs/features/integrations/calendar.md +7 -7
  21. package/agent-assets/docs/features/integrations/git.md +15 -13
  22. package/agent-assets/docs/features/integrations/github.md +12 -10
  23. package/agent-assets/docs/features/integrations/mail.md +47 -45
  24. package/agent-assets/docs/features/integrations/notion.md +15 -11
  25. package/agent-assets/docs/features/integrations/obsidian.md +27 -23
  26. package/agent-assets/docs/features/lifestyle/git.md +7 -8
  27. package/agent-assets/docs/features/lifestyle/reading.md +11 -8
  28. package/agent-assets/docs/features/lifestyle/receipts.md +21 -22
  29. package/agent-assets/docs/features/lifestyle/travel-bookings.md +9 -9
  30. package/agent-assets/docs/features/memory-files/agent-journal.md +12 -10
  31. package/agent-assets/docs/features/memory-files/agent-lessons.md +46 -21
  32. package/agent-assets/docs/features/memory-files/projects.md +13 -14
  33. package/agent-assets/docs/features/memory-files/roadmap.md +16 -15
  34. package/agent-assets/docs/features/memory-files/schedule.md +10 -10
  35. package/agent-assets/docs/features/memory-files/today.md +18 -18
  36. package/agent-assets/docs/features/memory-files/user-profile.md +17 -17
  37. package/agent-assets/docs/features/messaging/bang-commands.md +15 -15
  38. package/agent-assets/docs/features/messaging/dashboard-chat.md +7 -6
  39. package/agent-assets/docs/features/messaging/discord.md +7 -5
  40. package/agent-assets/docs/features/messaging/overview.md +14 -14
  41. package/agent-assets/docs/features/messaging/pairing-and-magic-phrase.md +12 -12
  42. package/agent-assets/docs/features/messaging/slack.md +9 -8
  43. package/agent-assets/docs/features/messaging/telegram.md +7 -7
  44. package/agent-assets/docs/features/messaging/whatsapp.md +6 -6
  45. package/agent-assets/docs/features/operations/activity-and-conversations.md +9 -9
  46. package/agent-assets/docs/features/operations/approvals.md +13 -12
  47. package/agent-assets/docs/features/operations/backend-routing.md +38 -37
  48. package/agent-assets/docs/features/operations/browser-tasks.md +63 -57
  49. package/agent-assets/docs/features/operations/cost-tracking.md +5 -5
  50. package/agent-assets/docs/features/operations/managed-chromium.md +23 -22
  51. package/agent-assets/docs/features/operations/notifications.md +15 -15
  52. package/agent-assets/docs/features/operations/quiet-hours.md +14 -15
  53. package/agent-assets/docs/features/operations/schedule-approaching.md +16 -14
  54. package/agent-assets/docs/features/routines/activity-scan.md +14 -11
  55. package/agent-assets/docs/features/routines/custom-routines.md +9 -7
  56. package/agent-assets/docs/features/routines/evening-review.md +6 -7
  57. package/agent-assets/docs/features/routines/morning-routine.md +22 -21
  58. package/agent-assets/docs/features/routines/weekly-review.md +57 -51
  59. package/agent-assets/docs/features/wiki/commands.md +27 -21
  60. package/agent-assets/docs/features/wiki/cost-and-approval.md +28 -23
  61. package/agent-assets/docs/features/wiki/dashboard.md +21 -23
  62. package/agent-assets/docs/features/wiki/overview.md +17 -25
  63. package/agent-assets/docs/features/wiki/search.md +15 -17
  64. package/agent-assets/docs/features/wiki/workspaces.md +55 -56
  65. package/agent-assets/docs/getting-started/01-what-is-this.md +3 -4
  66. package/agent-assets/docs/getting-started/02-first-steps.md +12 -13
  67. package/agent-assets/docs/getting-started/03-what-can-this-do.md +7 -7
  68. package/agent-assets/docs/getting-started/04-first-day.md +4 -5
  69. package/agent-assets/docs/glossary.md +17 -16
  70. package/agent-assets/docs/guides/add-a-custom-routine.md +17 -12
  71. package/agent-assets/docs/guides/backup-and-restore.md +19 -16
  72. package/agent-assets/docs/guides/budget-and-cost-for-wiki.md +55 -62
  73. package/agent-assets/docs/guides/build-your-wiki.md +11 -12
  74. package/agent-assets/docs/guides/change-which-model-handles-x.md +30 -28
  75. package/agent-assets/docs/guides/connect-a-new-mail-account.md +30 -29
  76. package/agent-assets/docs/guides/explore-with-trace-and-connect.md +30 -32
  77. package/agent-assets/docs/guides/import-knowledge-file.md +9 -10
  78. package/agent-assets/docs/guides/install-and-run.md +9 -10
  79. package/agent-assets/docs/guides/maintain-wiki-health.md +10 -10
  80. package/agent-assets/docs/guides/migrate-machines.md +16 -14
  81. package/agent-assets/docs/guides/multiple-wikis-for-multiple-domains.md +11 -12
  82. package/agent-assets/docs/guides/pause-the-agent.md +25 -25
  83. package/agent-assets/docs/guides/reinstall-cleanly.md +13 -12
  84. package/agent-assets/docs/guides/setup-wizard.md +9 -11
  85. package/agent-assets/docs/guides/switch-default-backend.md +9 -9
  86. package/agent-assets/docs/guides/use-an-existing-obsidian-vault.md +9 -11
  87. package/agent-assets/docs/pages/activity.md +76 -0
  88. package/agent-assets/docs/pages/agents.md +78 -0
  89. package/agent-assets/docs/pages/analytics.md +70 -0
  90. package/agent-assets/docs/pages/browser.md +73 -0
  91. package/agent-assets/docs/pages/chat.md +67 -0
  92. package/agent-assets/docs/pages/connections.md +78 -0
  93. package/agent-assets/docs/pages/git.md +73 -0
  94. package/agent-assets/docs/pages/knowledge.md +75 -0
  95. package/agent-assets/docs/pages/overview.md +90 -0
  96. package/agent-assets/docs/pages/reading.md +65 -0
  97. package/agent-assets/docs/pages/settings.md +77 -0
  98. package/agent-assets/docs/pages/tasks.md +74 -0
  99. package/agent-assets/docs/pages/wiki.md +73 -0
  100. package/agent-assets/docs/reference/api.md +18 -17
  101. package/agent-assets/docs/reference/cli-commands.md +13 -10
  102. package/agent-assets/docs/reference/config.md +40 -35
  103. package/agent-assets/docs/reference/disallowed-tools.md +18 -17
  104. package/agent-assets/docs/reference/keyboard-shortcuts.md +6 -8
  105. package/agent-assets/docs/reference/knowledge-layout.md +10 -10
  106. package/agent-assets/docs/reference/process-keys.md +20 -22
  107. package/agent-assets/docs/reference/skills.md +18 -16
  108. package/agent-assets/docs/troubleshooting/auth-failed.md +13 -11
  109. package/agent-assets/docs/troubleshooting/dashboard-shows-degraded.md +10 -10
  110. package/agent-assets/docs/troubleshooting/fallback-keeps-firing.md +26 -24
  111. package/agent-assets/docs/troubleshooting/messaging-not-pairing.md +8 -9
  112. package/agent-assets/docs/troubleshooting/morning-routine-didnt-run.md +19 -18
  113. package/agent-assets/docs/troubleshooting/observation-not-detected.md +14 -15
  114. package/agent-assets/docs/troubleshooting/quota-exhausted.md +28 -26
  115. package/agent-assets/docs/troubleshooting/wiki-ingest-full-blocked.md +35 -34
  116. package/agent-assets/docs/troubleshooting/wiki-write-failed.md +21 -24
  117. package/agent-assets/skills/agent-create/SKILL.md +39 -5
  118. package/agent-assets/skills/background-task/SKILL.md +9 -4
  119. package/agent-assets/skills/board/SKILL.md +8 -9
  120. package/agent-assets/skills/browser-task/SKILL.md +2 -0
  121. package/agent-assets/skills/context/seeds/file-responsibilities.seed.json +2 -1
  122. package/agent-assets/skills/schedule/SKILL.md +6 -5
  123. package/agent-assets/skills/sources/SKILL.md +68 -0
  124. package/agent-assets/skills/sources/curation.json +21 -0
  125. package/agent-assets/skills/sources/seeds/filing-rules.seed.json +25 -0
  126. package/agent-assets/skills/sources/seeds/source-collections.seed.json +20 -0
  127. package/agent-assets/skills/task/SKILL.md +5 -2
  128. package/agent-assets/task-flows/background_task.md +29 -3
  129. package/agent-assets/task-flows/message.received.dm.md +1 -1
  130. package/agent-assets/task-flows/routine.activity_scan.md +17 -2
  131. package/agent-assets/task-flows/routine.evening_review.md +72 -11
  132. package/agent-assets/task-flows/routine.fetch_window.md +21 -0
  133. package/agent-assets/task-flows/routine.monthly_review.md +3 -1
  134. package/agent-assets/task-flows/routine.morning_routine_today.md +26 -7
  135. package/agent-assets/task-flows/routine.source_maintenance.md +50 -0
  136. package/agent-assets/task-flows/scheduled.dm.md +8 -3
  137. package/agent-assets/templates/_manifest.json +1 -0
  138. package/agent-assets/templates/knowledge/sources/_index.md +19 -0
  139. package/package.json +4 -4
@@ -15,9 +15,7 @@ summary: |
15
15
  recipes for exporting your existing profile out of ChatGPT and Gemini.
16
16
  section: import-knowledge-file
17
17
  tags:
18
- - guides
19
18
  - knowledge
20
- - import
21
19
  - memory
22
20
  status: stable
23
21
  ask_examples:
@@ -27,7 +25,7 @@ ask_examples:
27
25
  - What format does the Knowledge upload accept?
28
26
  locale: en-US
29
27
  created: 2026-04-28
30
- updated: 2026-05-28
28
+ updated: 2026-07-01
31
29
  ui_anchors:
32
30
  - /knowledge
33
31
  keywords:
@@ -58,9 +56,10 @@ Bring a single Markdown (`.md`, `.markdown`) or plain-text (`.txt`)
58
56
  file you wrote elsewhere — a hand-written profile, an Obsidian or
59
57
  Notion export, or a summary you produced in ChatGPT / Gemini — into
60
58
  Aitne's `identity/*.md` Context Files. The agent reads the file once
61
- and appends each fact verbatim into the right topic file. Existing
62
- bullets are never overwritten; identity-class facts are deferred for
63
- your explicit confirmation.
59
+ and appends each fact, word for word, into the right topic file. It
60
+ never overwrites bullets you already have, and it holds back
61
+ identity-class facts — things like your legal name or timezone — until
62
+ you confirm them yourself.
64
63
 
65
64
  ## Prerequisites
66
65
 
@@ -130,8 +129,8 @@ date inline, so you can resolve them later without losing data.
130
129
  - **`415 unsupported_extension`** — the file is not `.md`,
131
130
  `.markdown`, or `.txt`. Convert PDFs / DOCX / HTML to plain
132
131
  Markdown first.
133
- - **`413 file_too_large`** — exceed 64 KB. Split the file into
134
- smaller chunks and upload each separately.
132
+ - **`413 file_too_large`** — the file is over 64 KB. Split it into
133
+ smaller chunks and upload each one separately.
135
134
  - **`400 secret_shape_detected`** — the route found content shaped
136
135
  like a private key or token. Remove the offending lines and re-
137
136
  upload.
@@ -152,8 +151,8 @@ following two paths produce a file that uploads cleanly.
152
151
  ### Recommended: ask ChatGPT to write it for you (≈ 2 min)
153
152
 
154
153
  Works against ChatGPT's *Memory* feature — the model already holds a
155
- list of personal facts about you. This procedure asks it to dump them
156
- in the exact format the upload expects.
154
+ list of personal facts about you. This recipe asks it to write those
155
+ out in the exact format the upload expects.
157
156
 
158
157
  1. Open <https://chatgpt.com> and start a **new conversation**. (Use
159
158
  a model with Memory enabled — GPT-4o, GPT-5, etc.)
@@ -15,12 +15,10 @@ summary: |
15
15
  start the daemon and dashboard, and open the dashboard at :8322.
16
16
  section: install-and-run
17
17
  tags:
18
- - core
19
- - guides
20
18
  - getting-started
21
- - install
22
19
  - setup
23
20
  - operations
21
+ - migration
24
22
  status: stable
25
23
  ask_examples:
26
24
  - How do I install Aitne?
@@ -29,7 +27,7 @@ ask_examples:
29
27
  - How do I install the aitne npm package?
30
28
  locale: en-US
31
29
  created: 2026-04-25
32
- updated: 2026-06-07
30
+ updated: 2026-07-01
33
31
  keywords:
34
32
  - install
35
33
  - first run
@@ -90,10 +88,10 @@ pnpm install
90
88
  pnpm start
91
89
  ```
92
90
 
93
- `pnpm start` builds first when the source is stale (mtime check against
94
- `.buildstamp`), then launches the daemon + dashboard detached. The
95
- `pnpm <cmd>` scripts are thin aliases that forward to
96
- `node bin/aitne.mjs <cmd>`.
91
+ `pnpm start` builds first if the source has changed since the last build
92
+ (a modified-time check against `.buildstamp`), then launches the daemon
93
+ and dashboard in the background. The `pnpm <cmd>` scripts are thin aliases
94
+ that forward to `node bin/aitne.mjs <cmd>`.
97
95
 
98
96
  ### Then, for both paths
99
97
 
@@ -101,8 +99,9 @@ Open `http://localhost:8322` and follow the setup wizard.
101
99
 
102
100
  ## Verification
103
101
 
104
- - `aitne status` (or `pnpm status` from a clone) shows two PIDs (daemon
105
- + dashboard), uptime, connected backends, and a green health pill.
102
+ - `aitne status` (or `pnpm status` from a clone) shows two process IDs
103
+ (one for the daemon, one for the dashboard), uptime, connected backends,
104
+ and a green health pill.
106
105
  - `~/.personal-agent/` has been created, containing
107
106
  `data/personal_agent.db`, `context/`, and `logs/`.
108
107
 
@@ -16,7 +16,6 @@ summary: |
16
16
  approval before promoting them.
17
17
  section: maintain-wiki-health
18
18
  tags:
19
- - guides
20
19
  - wiki
21
20
  - health
22
21
  status: stable
@@ -28,7 +27,7 @@ ask_examples:
28
27
  - What is a taxonomy candidate?
29
28
  locale: en-US
30
29
  created: 2026-05-12
31
- updated: 2026-06-07
30
+ updated: 2026-07-01
32
31
  keywords:
33
32
  - wiki health
34
33
  - wiki lint
@@ -59,11 +58,12 @@ ui_anchors:
59
58
 
60
59
  # Maintain Wiki Health
61
60
 
62
- The wiki is a living artifact. Notes accumulate, sources drift,
63
- slugs collide, and the taxonomy slowly diverges from the vocabulary
64
- your raw notes actually use. `!lint` is the periodic audit pass
65
- that surfaces all of this in one report without changing your
66
- notes itself.
61
+ The wiki is a living thing. Notes pile up, sources go stale,
62
+ slugs (the short id each note is filed under) collide, and the
63
+ taxonomy the list of canonical topic names your notes are filed
64
+ under slowly drifts away from the words your raw notes actually
65
+ use. `!lint` is the periodic audit that surfaces all of this in one
66
+ report, without changing any of your notes.
67
67
 
68
68
  ## When to Run
69
69
 
@@ -120,7 +120,7 @@ page is also reachable from a button at the top of `/settings/wiki`,
120
120
  and the same view is mirrored under `/settings/wiki/timeline`. The
121
121
  most-recent report is parsed and rendered with:
122
122
 
123
- - A coloured date badge.
123
+ - A colored date badge.
124
124
  - The `## Summary` bullets.
125
125
  - The `## Action items` list (this is the part you actually act on).
126
126
  - A "View full report" expander showing the raw Markdown for
@@ -132,8 +132,8 @@ that produced the state.
132
132
 
133
133
  ## Acting on Action Items
134
134
 
135
- The audit never modifies content layers itself. For each action
136
- item:
135
+ The audit never edits your notes itself — it only reports. For each
136
+ action item:
137
137
 
138
138
  - **Orphan** → either link the note from `20_wiki/_index.md` and
139
139
  related notes, or archive it. From a DM you can run `!ask` to
@@ -15,7 +15,6 @@ summary: |
15
15
  because schema migrations auto-forward at boot.
16
16
  section: migrate-machines
17
17
  tags:
18
- - guides
19
18
  - operations
20
19
  - migration
21
20
  - backup
@@ -25,7 +24,7 @@ ask_examples:
25
24
  - Will my DB still work after upgrading on the new machine?
26
25
  locale: en-US
27
26
  created: 2026-04-25
28
- updated: 2026-05-28
27
+ updated: 2026-07-01
29
28
  keywords:
30
29
  - migrate
31
30
  - move install
@@ -50,22 +49,25 @@ context-file history or activity logs.
50
49
  | `~/.personal-agent/data/personal_agent.db` (sessions, actions, observations, FTS) | Messaging pairing tokens (Slack / Telegram / Discord / WhatsApp) |
51
50
  | `~/.personal-agent/logs/` (optional — for reference) | Integration OAuth grants (Gmail / Google Calendar / Notion) |
52
51
 
53
- The DB carries cleanly even across daemon versions: at boot, Aitne
54
- runs forward-only migrations from `packages/daemon/src/db/migrations.ts`
55
- that bring older schemas up to the current shape. As long as you're
56
- upgrading (not downgrading), the same DB works.
52
+ The database carries cleanly even across daemon versions. Each time it
53
+ starts, Aitne runs forward-only migrations from
54
+ `packages/daemon/src/db/migrations.ts` one-way updates that bring an
55
+ older database up to the current shape. As long as you're upgrading
56
+ (not downgrading), the same database works.
57
57
 
58
58
  ## Steps
59
59
 
60
- 1. **On the old machine:** stop the daemon.
60
+ 1. **On the old machine:** stop the daemon (the background Aitne process).
61
61
  ```bash
62
62
  aitne stop
63
63
  ```
64
- 2. **Copy the data directory** to the new machine — context plus DB.
64
+ 2. **Copy the data directory** to the new machine — the context files
65
+ plus the database. The command below uses `rsync`, a standard
66
+ file-copy tool.
65
67
  ```bash
66
68
  rsync -av ~/.personal-agent/ user@new-host:~/.personal-agent/
67
69
  ```
68
- (Or rsync just `context/` and `data/` if you want to skip logs.)
70
+ (Or copy just `context/` and `data/` if you want to skip the logs.)
69
71
  3. **On the new machine:** install per [Install and Run](install-and-run.md).
70
72
  4. **Re-register secrets and re-pair messaging** through the dashboard:
71
73
  - Re-register each backend's API key, or re-run its CLI auth flow for
@@ -73,16 +75,16 @@ upgrading (not downgrading), the same DB works.
73
75
  Gemini run `gemini` and choose **Sign in with Google**.
74
76
  - Walk the setup wizard's messaging pairing steps for each app you
75
77
  had paired.
76
- - Re-authorize each integration's OAuth grant (Gmail / Calendar /
77
- Notion are the common ones).
78
+ - Re-authorize each integration's OAuth grant the access you
79
+ approved for Gmail, Calendar, and Notion (the common ones).
78
80
  5. Start the daemon.
79
81
  ```bash
80
82
  aitne start
81
83
  ```
82
84
 
83
- On first boot the migration runner brings the carried DB up to the
84
- new daemon's schema. Check the daemon log if you want to see exactly
85
- which migrations applied:
85
+ On first boot the migration runner brings the carried database up to
86
+ the new daemon's schema. Check the daemon log if you want to see
87
+ exactly which migrations applied:
86
88
 
87
89
  ```bash
88
90
  aitne logs -n 200 | grep -i migration
@@ -15,7 +15,6 @@ summary: |
15
15
  on disk.
16
16
  section: guides
17
17
  tags:
18
- - guides
19
18
  - wiki
20
19
  - workspaces
21
20
  - knowledge
@@ -26,7 +25,7 @@ ask_examples:
26
25
  - What does `@research` do before a wiki command?
27
26
  locale: en-US
28
27
  created: 2026-05-12
29
- updated: 2026-05-28
28
+ updated: 2026-07-01
30
29
  keywords:
31
30
  - multi-workspace
32
31
  - wiki workspace
@@ -76,10 +75,10 @@ DM agent routes commands per workspace; the file trees never overlap.
76
75
  pull from your parenting journal. Separate workspaces give you
77
76
  separate `_index.md` and `20_wiki/` trees so the agent never has to
78
77
  filter across domains.
79
- - **Different audiences.** A workspace synced via Obsidian to a shared
80
- iCloud folder for a team is governed differently from the daemon's
81
- internal workspace under its data directory. Per-workspace settings
82
- handle the asymmetry.
78
+ - **Different audiences.** A workspace that Obsidian syncs to a shared
79
+ iCloud folder for a team needs different handling from the daemon's
80
+ own internal workspace under its data directory. Per-workspace
81
+ settings let you treat each one on its own terms.
83
82
  - **Different cadences.** A "current project" wiki gets multiple
84
83
  ingests per day; a long-term commonplace book may compile weekly.
85
84
  Per-workspace dispatch / cost / approval thresholds let you tune
@@ -138,12 +137,12 @@ comma-separated arguments verbatim.
138
137
 
139
138
  ## What the agent sees per workspace
140
139
 
141
- Each session is materialised against a single workspace's tree. The
142
- `wiki-vault-rules` skill loaded for the session names that workspace's
143
- language, dispatch mode, layer invariants, and frontmatter
144
- conventions. Layer authorisation in the daemon API is workspace-scoped
145
- a `wiki.ask` session against `@research` cannot reach into
146
- `@parenting`'s `10_raw/` even if the agent attempts it.
140
+ Each session works against a single workspace's file tree. The
141
+ `wiki-vault-rules` skill loaded for the session spells out that
142
+ workspace's language, dispatch mode, layer rules, and frontmatter
143
+ conventions. Access to vault layers is workspace-scoped in the daemon
144
+ API: a `wiki.ask` session against `@research` cannot reach into
145
+ `@parenting`'s `10_raw/`, even if the agent tries.
147
146
 
148
147
  ## `!wiki` status with multiple workspaces
149
148
 
@@ -12,7 +12,6 @@ summary: |
12
12
  every routine, or use dashboard toggles and quiet hours for finer control.
13
13
  section: pause-the-agent
14
14
  tags:
15
- - guides
16
15
  - operations
17
16
  - messaging
18
17
  - autonomous
@@ -23,7 +22,7 @@ ask_examples:
23
22
  - Can I disable everything for a week?
24
23
  locale: en-US
25
24
  created: 2026-04-25
26
- updated: 2026-06-10
25
+ updated: 2026-07-01
27
26
  keywords:
28
27
  - pause agent
29
28
  - stop agent
@@ -58,24 +57,25 @@ losing your install.
58
57
 
59
58
  ## The fastest pause: `!stop`
60
59
 
61
- DM `!stop` to the agent on any paired messaging app. This is the
62
- recommended way to go silent and the only one you need for most cases:
60
+ DM `!stop` to the agent on any paired messaging app (any chat app you
61
+ have connected). This is the recommended way to go silent, and the only
62
+ step you need for most cases:
63
63
 
64
- - It pauses **every** cron-driven routine — morning, evening, weekly,
64
+ - It pauses **every** scheduled routine — morning, evening, weekly,
65
65
  monthly, and the activity scan — not just one of them.
66
- - Non-command DMs are declined with a paused notice (no LLM cost)
67
- until you resume.
68
- - The paused state is persisted, so a daemon restart does **not**
69
- silently resume autonomous work.
70
- - In-flight runs are not aborted; the pause takes effect from the next
71
- scheduled tick.
66
+ - While paused, a plain (non-command) DM gets a short "paused" reply
67
+ instead of an answer, so it costs nothing to run.
68
+ - The pause is saved to disk, so restarting the daemon does **not**
69
+ quietly start the agent working again.
70
+ - A run that is already in progress keeps going; the pause applies from
71
+ the next scheduled run onward.
72
72
 
73
73
  Resume with `!start` whenever you want the agent active again. See
74
74
  [Bang Commands](../features/messaging/bang-commands.md).
75
75
 
76
76
  ## Finer-grained control from the dashboard
77
77
 
78
- If you want to mute specific behaviour rather than pause everything:
78
+ If you want to quiet one specific behavior rather than pause everything:
79
79
 
80
80
  1. **Disable the activity scan** — open `/agents/activity-scan` and click
81
81
  **Disable**. This leaves the morning, evening, weekly, and monthly
@@ -90,22 +90,22 @@ If you want to mute specific behaviour rather than pause everything:
90
90
  take an `HH:MM` string. Routines still run; they just don't notify
91
91
  you.
92
92
 
93
- Morning (fires at the day boundary, default 04:00), evening (18:00),
94
- and weekly (Fri 19:00) reviews each have a per-routine Enable/Disable
95
- toggle on the `/agents` page — open `/agents/<slug>` (e.g.
96
- `/agents/weekly-review`) and click Disable (a stop-warning confirmation
97
- appears for these system agents). To halt all of them at once, use
98
- `!stop` above instead. Each routine's instructions (its rulebook) are
99
- edited on the same page's **Rulebook** tab
100
- (`/agents/<slug>?tab=rulebook`).
93
+ The morning review (fires at the day boundary the moment "today"
94
+ rolls over, 04:00 by default), evening (18:00), and weekly (Fri 19:00)
95
+ reviews each have their own Enable/Disable toggle on the `/agents`
96
+ page. Open `/agents/<slug>` (e.g. `/agents/weekly-review`) and click
97
+ Disable; a stop-warning confirmation appears for these system agents.
98
+ To halt all of them at once, use `!stop` above instead. To edit a
99
+ routine's instructions (its rulebook), use the same page's **Rulebook**
100
+ tab (`/agents/<slug>?tab=rulebook`).
101
101
 
102
102
  ## Last resort: stop the daemon
103
103
 
104
- `aitne stop` shuts the daemon down entirely (graceful SIGTERM, then
105
- SIGKILL after 10 seconds). Nothing runs — no routines, no messaging, no
106
- dashboard. Use this only when you want the agent fully offline; for a
107
- temporary pause that survives across days, prefer `!stop`. Restart with
108
- `aitne start`.
104
+ `aitne stop` shuts the daemon down entirely: it asks the process to
105
+ quit (SIGTERM), then forces it (SIGKILL) after 10 seconds. Nothing
106
+ runs — no routines, no messaging, no dashboard. Use this only when you
107
+ want the agent fully offline. For a temporary pause that survives across
108
+ days, prefer `!stop`. Restart with `aitne start`.
109
109
 
110
110
  ## Verification
111
111
 
@@ -17,9 +17,7 @@ summary: |
17
17
  DB is genuinely corrupt.
18
18
  section: reinstall-cleanly
19
19
  tags:
20
- - guide
21
20
  - operations
22
- - reinstall
23
21
  - migration
24
22
  - backup
25
23
  status: stable
@@ -30,7 +28,7 @@ ask_examples:
30
28
  - Do I need to wipe the DB to upgrade Aitne?
31
29
  locale: en-US
32
30
  created: 2026-04-25
33
- updated: 2026-05-28
31
+ updated: 2026-07-01
34
32
  keywords:
35
33
  - reinstall
36
34
  - factory reset
@@ -54,10 +52,12 @@ ui_anchors:
54
52
 
55
53
  ## You Almost Never Need This
56
54
 
57
- Aitne upgrades through **forward-only schema migrations** applied at
58
- daemon boot your DB and context files survive every
55
+ Aitne upgrades itself safely. Each time the background service (the
56
+ **daemon**) starts, it runs **forward-only schema migrations** small
57
+ scripts that update the database structure without erasing anything. So
58
+ your database and context files survive every
59
59
  `npm install -g @aitne-sh/aitne@latest` upgrade. If you're reading this
60
- because you just upgraded, **don't run the steps below**; restart the
60
+ right after upgrading, **don't run the steps below.** Just restart the
61
61
  daemon and let the migration runner do its job.
62
62
 
63
63
  This guide is the last-resort escape hatch for:
@@ -97,8 +97,8 @@ with different scopes — make sure you're running the one you mean:
97
97
  ```bash
98
98
  cp -R ~/.personal-agent/context backup/
99
99
  ```
100
- Context Markdown is what makes the agent know who you are; the DB is
101
- recoverable, context is not.
100
+ Context Markdown is how the agent knows who you are; the DB can be
101
+ rebuilt, but context cannot.
102
102
  3. **Back up the DB** if there's any chance you'll want to recover it
103
103
  later:
104
104
  ```bash
@@ -115,8 +115,9 @@ with different scopes — make sure you're running the one you mean:
115
115
  ```bash
116
116
  rm ~/.personal-agent/data/personal_agent.db*
117
117
  ```
118
- (The `*` glob clears `-shm` / `-wal` left behind by WAL mode. The DB
119
- lives inside `data/`, not at the top of the data dir.)
118
+ (The `*` at the end also clears the `-shm` and `-wal` helper files
119
+ that SQLite's write-ahead log leaves behind. The DB lives inside
120
+ `data/`, not at the top of the data dir.)
120
121
  3. Start the daemon.
121
122
  ```bash
122
123
  aitne start
@@ -135,5 +136,5 @@ with different scopes — make sure you're running the one you mean:
135
136
 
136
137
  - [Backup and Restore](backup-and-restore.md)
137
138
  - [Migrate Machines](migrate-machines.md)
138
- - [Schema Migration](../glossary.md#schema-migration) — the boring
139
- alternative to this guide that runs automatically on every boot.
139
+ - [Glossary: Schema Migration](../glossary.md) — the boring alternative
140
+ to this guide that runs automatically on every boot.
@@ -15,8 +15,6 @@ summary: |
15
15
  Rules step.
16
16
  section: guides
17
17
  tags:
18
- - core
19
- - guides
20
18
  - getting-started
21
19
  - setup
22
20
  - backends
@@ -29,7 +27,7 @@ ask_examples:
29
27
  - Where do I paste my API key?
30
28
  locale: en-US
31
29
  created: 2026-04-25
32
- updated: 2026-06-10
30
+ updated: 2026-07-01
33
31
  keywords:
34
32
  - setup
35
33
  - wizard
@@ -65,10 +63,10 @@ ui_anchors:
65
63
 
66
64
  ## Goal
67
65
 
68
- Take a fresh install through the wizard with informed answers at each
69
- step. The wizard is rerunnable any time at `/setup?mode=update`, which
70
- jumps straight to the Customize Rules step so you can refine the agent
71
- without redoing the whole flow.
66
+ Walk a fresh install through the wizard, making an informed choice at
67
+ each step. You can rerun the wizard any time at `/setup?mode=update`,
68
+ which jumps straight to the Customize Rules step so you can refine the
69
+ agent without redoing the whole flow.
72
70
 
73
71
  ## Prerequisites
74
72
 
@@ -77,10 +75,10 @@ without redoing the whole flow.
77
75
 
78
76
  ## The steps at a glance
79
77
 
80
- The wizard has eight collection steps plus a terminal "Done" screen.
81
- Three are required (**Basics**, **Vault**, **AI Backend**, plus
82
- **Customize Rules**); the four integration/messaging steps are
83
- skippable and re-runnable later.
78
+ The wizard has eight collection steps plus a final "Done" screen. Four
79
+ of them are required **Basics**, **Vault**, **AI Backend**, and
80
+ **Customize Rules**; the other four (the integration and messaging
81
+ steps) are skippable, and you can run them later.
84
82
 
85
83
  | # | Step | Required? | What it sets |
86
84
  |---|------|-----------|--------------|
@@ -14,7 +14,6 @@ summary: |
14
14
  different backend.
15
15
  section: switch-default-backend
16
16
  tags:
17
- - guides
18
17
  - backends
19
18
  - operations
20
19
  - routing
@@ -25,7 +24,7 @@ ask_examples:
25
24
  - How do I change the main backend the agent uses?
26
25
  locale: en-US
27
26
  created: 2026-04-25
28
- updated: 2026-05-28
27
+ updated: 2026-07-01
29
28
  keywords:
30
29
  - main backend
31
30
  - switch backend
@@ -52,9 +51,10 @@ api_endpoints:
52
51
  ## Goal
53
52
 
54
53
  Change which backend the agent uses by default for most work —
55
- `claude`, `codex`, `gemini`, or `opencode`. This is the broad switch
56
- that re-seeds every ProcessKey to the new backend's per-tier default
57
- models. To change just one ProcessKey instead, see
54
+ `claude`, `codex`, `gemini`, or `opencode`. This is the broad switch:
55
+ it re-seeds every ProcessKey (each named job the agent runs, like a DM
56
+ reply or a morning routine) to the new backend's default model for
57
+ that job's tier. To change just one ProcessKey instead, see
58
58
  [Change which model handles X](change-which-model-handles-x.md).
59
59
 
60
60
  ## Prerequisites
@@ -65,10 +65,10 @@ will start failing the moment it routes work there.
65
65
  - Register an API key for the backend on `/settings/models`
66
66
  (`anthropic` / `openai` / `google`, or one of the cloud-provider
67
67
  options for that backend).
68
- - API keys are the supported path. If no key is set, the daemon falls
69
- back to whatever subscription login the backend's CLI already has —
70
- the auth-health card on `/settings/models` flags this so you can
71
- tell which credential is actually in use.
68
+ - An API key is the supported way in. If no key is set, the daemon
69
+ falls back to whatever subscription login the backend's CLI already
70
+ has — the auth-health card on `/settings/models` flags this so you
71
+ can tell which credential is actually in use.
72
72
 
73
73
  ## Steps
74
74
 
@@ -14,9 +14,7 @@ summary: |
14
14
  through Adopt vs Migrate vs Split.
15
15
  section: use-an-existing-obsidian-vault
16
16
  tags:
17
- - guides
18
17
  - wiki
19
- - obsidian
20
18
  - knowledge
21
19
  status: stable
22
20
  ask_examples:
@@ -26,7 +24,7 @@ ask_examples:
26
24
  - Why is Split greyed out?
27
25
  locale: en-US
28
26
  created: 2026-05-12
29
- updated: 2026-06-07
27
+ updated: 2026-07-01
30
28
  keywords:
31
29
  - external vault
32
30
  - existing obsidian vault
@@ -58,11 +56,11 @@ process_keys:
58
56
 
59
57
  ## Goal
60
58
 
61
- Aitne can point the wiki subsystem at a vault you already maintain
62
- in Obsidian, instead of creating its own at `$PA_DATA_DIR/wiki`.
63
- This is "external mode", and the setup wizard walks you through
64
- three decisions: **probe**, **classify**, then **Adopt vs Migrate
65
- vs Split**.
59
+ Aitne can point the wiki at a vault you already keep in Obsidian,
60
+ instead of creating its own at `$PA_DATA_DIR/wiki`. This is called
61
+ "external mode". The setup wizard walks you through three steps:
62
+ it **probes** the folder you pick, **classifies** what it finds,
63
+ then asks you to choose **Adopt vs Migrate vs Split**.
66
64
 
67
65
  ## Step 1 — Open Settings → Wiki
68
66
 
@@ -110,9 +108,9 @@ levels:
110
108
  an existing wiki layout is detected, the wizard will surface the
111
109
  Adopt / Migrate decision in Step 3.
112
110
 
113
- The **Use this folder** button is greyed out while the banner
114
- is an error so you cannot fire a workspace-create that the daemon
115
- already knows will fail.
111
+ The **Use this folder** button stays greyed out while the banner
112
+ shows an error, so you cannot start a workspace-create that the
113
+ daemon already knows will fail.
116
114
 
117
115
  ## Step 2 — Probe Classifies the Vault
118
116
 
@@ -0,0 +1,76 @@
1
+ ---
2
+ schema_version: 1
3
+ slug: pages/activity
4
+ title: "Agent Log Page"
5
+ id: page-activity
6
+ aliases:
7
+ - agent log page
8
+ - activity page
9
+ - log page
10
+ - conversations page
11
+ category: pages
12
+ summary: |
13
+ The Agent Log is the historical record of everything the agent has seen
14
+ or done — invocations (Events), daemon output (System Logs), completed
15
+ chat threads (Conversations), and proactive outbound messages
16
+ (Notifications).
17
+ tags:
18
+ - audit
19
+ - notifications
20
+ - operations
21
+ status: stable
22
+ ask_examples:
23
+ - What can I do on the Agent Log page?
24
+ - Where do I see why a routine failed?
25
+ - Where do I read a full conversation transcript?
26
+ - Where are the daemon's system logs?
27
+ locale: en-US
28
+ created: 2026-07-01
29
+ updated: 2026-07-01
30
+ keywords:
31
+ - agent log
32
+ - activity
33
+ - events
34
+ - system logs
35
+ - conversations
36
+ - notifications
37
+ related:
38
+ - features/operations/activity-and-conversations
39
+ - features/operations/notifications
40
+ - features/operations/backend-routing
41
+ - pages/analytics
42
+ ui_anchors:
43
+ - /activity
44
+ - /conversations
45
+ ---
46
+
47
+ # Agent Log Page
48
+
49
+ The `/activity` page is the agent's audit trail — a permanent record you can
50
+ look back on of everything the agent has seen or done, split across four tabs.
51
+
52
+ ## What you can do here
53
+
54
+ - **Events** — one row each time the agent ran (an "invocation"): what
55
+ triggered the run, which backend served it, and whether it succeeded or
56
+ failed. This is where you diagnose a routine that didn't do what you expected.
57
+ - **System Logs** — output from the daemon itself: startup messages, errors,
58
+ and warnings from the Hono server.
59
+ - **Conversations** — completed chat threads from every messaging platform,
60
+ each of which you can open as a full transcript.
61
+ - **Notifications** — messages the agent sent you on its own, without you
62
+ asking.
63
+
64
+ ## Where to go deeper
65
+
66
+ - [Activity & Conversations](../features/operations/activity-and-conversations.md)
67
+ — the audit timeline and per-session transcripts in detail.
68
+ - [Notifications](../features/operations/notifications.md) — when and how
69
+ the agent reaches out.
70
+ - [Backend routing](../features/operations/backend-routing.md) — how to
71
+ read the "which backend served it" column.
72
+
73
+ ## Related
74
+
75
+ - [Analytics page](analytics.md) — the aggregated view of this same data.
76
+ - [Overview page](overview.md) — the recent-events feed is a slice of Events.