@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.
- package/agent-assets/agent-profiles/background-task.md +8 -1
- package/agent-assets/agent-profiles/routine-fetch-window.md +11 -0
- package/agent-assets/agents/evening-review/agent.md +6 -2
- package/agent-assets/agents/lesson-maintenance/agent.md +56 -0
- package/agent-assets/agents/morning-routine/agent.md +7 -2
- package/agent-assets/agents/source-librarian/agent.md +51 -0
- package/agent-assets/docs/concepts/agent-day.md +15 -15
- package/agent-assets/docs/concepts/auth-health.md +10 -7
- package/agent-assets/docs/concepts/backends-and-tiers.md +21 -13
- package/agent-assets/docs/concepts/costs-and-quotas.md +10 -10
- package/agent-assets/docs/concepts/delegated-mode.md +18 -18
- package/agent-assets/docs/concepts/memory-model.md +25 -24
- package/agent-assets/docs/concepts/observations.md +27 -19
- package/agent-assets/docs/concepts/process-keys.md +25 -26
- package/agent-assets/docs/concepts/routines.md +18 -17
- package/agent-assets/docs/concepts/safety-and-execution.md +20 -17
- package/agent-assets/docs/concepts/safety-model.md +16 -15
- package/agent-assets/docs/concepts/skills.md +7 -4
- package/agent-assets/docs/features/integrations/browser-history.md +52 -47
- package/agent-assets/docs/features/integrations/calendar.md +7 -7
- package/agent-assets/docs/features/integrations/git.md +15 -13
- package/agent-assets/docs/features/integrations/github.md +12 -10
- package/agent-assets/docs/features/integrations/mail.md +47 -45
- package/agent-assets/docs/features/integrations/notion.md +15 -11
- package/agent-assets/docs/features/integrations/obsidian.md +27 -23
- package/agent-assets/docs/features/lifestyle/git.md +7 -8
- package/agent-assets/docs/features/lifestyle/reading.md +11 -8
- package/agent-assets/docs/features/lifestyle/receipts.md +21 -22
- package/agent-assets/docs/features/lifestyle/travel-bookings.md +9 -9
- package/agent-assets/docs/features/memory-files/agent-journal.md +12 -10
- package/agent-assets/docs/features/memory-files/agent-lessons.md +46 -21
- package/agent-assets/docs/features/memory-files/projects.md +13 -14
- package/agent-assets/docs/features/memory-files/roadmap.md +16 -15
- package/agent-assets/docs/features/memory-files/schedule.md +10 -10
- package/agent-assets/docs/features/memory-files/today.md +18 -18
- package/agent-assets/docs/features/memory-files/user-profile.md +17 -17
- package/agent-assets/docs/features/messaging/bang-commands.md +15 -15
- package/agent-assets/docs/features/messaging/dashboard-chat.md +7 -6
- package/agent-assets/docs/features/messaging/discord.md +7 -5
- package/agent-assets/docs/features/messaging/overview.md +14 -14
- package/agent-assets/docs/features/messaging/pairing-and-magic-phrase.md +12 -12
- package/agent-assets/docs/features/messaging/slack.md +9 -8
- package/agent-assets/docs/features/messaging/telegram.md +7 -7
- package/agent-assets/docs/features/messaging/whatsapp.md +6 -6
- package/agent-assets/docs/features/operations/activity-and-conversations.md +9 -9
- package/agent-assets/docs/features/operations/approvals.md +13 -12
- package/agent-assets/docs/features/operations/backend-routing.md +38 -37
- package/agent-assets/docs/features/operations/browser-tasks.md +63 -57
- package/agent-assets/docs/features/operations/cost-tracking.md +5 -5
- package/agent-assets/docs/features/operations/managed-chromium.md +23 -22
- package/agent-assets/docs/features/operations/notifications.md +15 -15
- package/agent-assets/docs/features/operations/quiet-hours.md +14 -15
- package/agent-assets/docs/features/operations/schedule-approaching.md +16 -14
- package/agent-assets/docs/features/routines/activity-scan.md +14 -11
- package/agent-assets/docs/features/routines/custom-routines.md +9 -7
- package/agent-assets/docs/features/routines/evening-review.md +6 -7
- package/agent-assets/docs/features/routines/morning-routine.md +22 -21
- package/agent-assets/docs/features/routines/weekly-review.md +57 -51
- package/agent-assets/docs/features/wiki/commands.md +27 -21
- package/agent-assets/docs/features/wiki/cost-and-approval.md +28 -23
- package/agent-assets/docs/features/wiki/dashboard.md +21 -23
- package/agent-assets/docs/features/wiki/overview.md +17 -25
- package/agent-assets/docs/features/wiki/search.md +15 -17
- package/agent-assets/docs/features/wiki/workspaces.md +55 -56
- package/agent-assets/docs/getting-started/01-what-is-this.md +3 -4
- package/agent-assets/docs/getting-started/02-first-steps.md +12 -13
- package/agent-assets/docs/getting-started/03-what-can-this-do.md +7 -7
- package/agent-assets/docs/getting-started/04-first-day.md +4 -5
- package/agent-assets/docs/glossary.md +17 -16
- package/agent-assets/docs/guides/add-a-custom-routine.md +17 -12
- package/agent-assets/docs/guides/backup-and-restore.md +19 -16
- package/agent-assets/docs/guides/budget-and-cost-for-wiki.md +55 -62
- package/agent-assets/docs/guides/build-your-wiki.md +11 -12
- package/agent-assets/docs/guides/change-which-model-handles-x.md +30 -28
- package/agent-assets/docs/guides/connect-a-new-mail-account.md +30 -29
- package/agent-assets/docs/guides/explore-with-trace-and-connect.md +30 -32
- package/agent-assets/docs/guides/import-knowledge-file.md +9 -10
- package/agent-assets/docs/guides/install-and-run.md +9 -10
- package/agent-assets/docs/guides/maintain-wiki-health.md +10 -10
- package/agent-assets/docs/guides/migrate-machines.md +16 -14
- package/agent-assets/docs/guides/multiple-wikis-for-multiple-domains.md +11 -12
- package/agent-assets/docs/guides/pause-the-agent.md +25 -25
- package/agent-assets/docs/guides/reinstall-cleanly.md +13 -12
- package/agent-assets/docs/guides/setup-wizard.md +9 -11
- package/agent-assets/docs/guides/switch-default-backend.md +9 -9
- package/agent-assets/docs/guides/use-an-existing-obsidian-vault.md +9 -11
- package/agent-assets/docs/pages/activity.md +76 -0
- package/agent-assets/docs/pages/agents.md +78 -0
- package/agent-assets/docs/pages/analytics.md +70 -0
- package/agent-assets/docs/pages/browser.md +73 -0
- package/agent-assets/docs/pages/chat.md +67 -0
- package/agent-assets/docs/pages/connections.md +78 -0
- package/agent-assets/docs/pages/git.md +73 -0
- package/agent-assets/docs/pages/knowledge.md +75 -0
- package/agent-assets/docs/pages/overview.md +90 -0
- package/agent-assets/docs/pages/reading.md +65 -0
- package/agent-assets/docs/pages/settings.md +77 -0
- package/agent-assets/docs/pages/tasks.md +74 -0
- package/agent-assets/docs/pages/wiki.md +73 -0
- package/agent-assets/docs/reference/api.md +18 -17
- package/agent-assets/docs/reference/cli-commands.md +13 -10
- package/agent-assets/docs/reference/config.md +40 -35
- package/agent-assets/docs/reference/disallowed-tools.md +18 -17
- package/agent-assets/docs/reference/keyboard-shortcuts.md +6 -8
- package/agent-assets/docs/reference/knowledge-layout.md +10 -10
- package/agent-assets/docs/reference/process-keys.md +20 -22
- package/agent-assets/docs/reference/skills.md +18 -16
- package/agent-assets/docs/troubleshooting/auth-failed.md +13 -11
- package/agent-assets/docs/troubleshooting/dashboard-shows-degraded.md +10 -10
- package/agent-assets/docs/troubleshooting/fallback-keeps-firing.md +26 -24
- package/agent-assets/docs/troubleshooting/messaging-not-pairing.md +8 -9
- package/agent-assets/docs/troubleshooting/morning-routine-didnt-run.md +19 -18
- package/agent-assets/docs/troubleshooting/observation-not-detected.md +14 -15
- package/agent-assets/docs/troubleshooting/quota-exhausted.md +28 -26
- package/agent-assets/docs/troubleshooting/wiki-ingest-full-blocked.md +35 -34
- package/agent-assets/docs/troubleshooting/wiki-write-failed.md +21 -24
- package/agent-assets/skills/agent-create/SKILL.md +39 -5
- package/agent-assets/skills/background-task/SKILL.md +9 -4
- package/agent-assets/skills/board/SKILL.md +8 -9
- package/agent-assets/skills/browser-task/SKILL.md +2 -0
- package/agent-assets/skills/context/seeds/file-responsibilities.seed.json +2 -1
- package/agent-assets/skills/schedule/SKILL.md +6 -5
- package/agent-assets/skills/sources/SKILL.md +68 -0
- package/agent-assets/skills/sources/curation.json +21 -0
- package/agent-assets/skills/sources/seeds/filing-rules.seed.json +25 -0
- package/agent-assets/skills/sources/seeds/source-collections.seed.json +20 -0
- package/agent-assets/skills/task/SKILL.md +5 -2
- package/agent-assets/task-flows/background_task.md +29 -3
- package/agent-assets/task-flows/message.received.dm.md +1 -1
- package/agent-assets/task-flows/routine.activity_scan.md +17 -2
- package/agent-assets/task-flows/routine.evening_review.md +72 -11
- package/agent-assets/task-flows/routine.fetch_window.md +21 -0
- package/agent-assets/task-flows/routine.monthly_review.md +3 -1
- package/agent-assets/task-flows/routine.morning_routine_today.md +26 -7
- package/agent-assets/task-flows/routine.source_maintenance.md +50 -0
- package/agent-assets/task-flows/scheduled.dm.md +8 -3
- package/agent-assets/templates/_manifest.json +1 -0
- package/agent-assets/templates/knowledge/sources/_index.md +19 -0
- 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-
|
|
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
|
|
62
|
-
bullets
|
|
63
|
-
your
|
|
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`** —
|
|
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
|
|
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-
|
|
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
|
|
94
|
-
`.buildstamp`), then launches the daemon
|
|
95
|
-
`pnpm <cmd>` scripts are thin aliases
|
|
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
|
|
105
|
-
|
|
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-
|
|
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
|
|
63
|
-
slugs
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
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
|
|
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
|
|
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-
|
|
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
|
|
54
|
-
runs forward-only migrations from
|
|
55
|
-
|
|
56
|
-
|
|
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
|
|
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
|
|
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
|
|
77
|
-
Notion
|
|
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
|
|
84
|
-
new daemon's schema. Check the daemon log if you want to see
|
|
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-
|
|
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
|
|
80
|
-
iCloud folder for a team
|
|
81
|
-
internal workspace under its data directory. Per-workspace
|
|
82
|
-
|
|
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
|
|
142
|
-
`wiki-vault-rules` skill loaded for the session
|
|
143
|
-
language, dispatch mode, layer
|
|
144
|
-
conventions.
|
|
145
|
-
|
|
146
|
-
`@parenting`'s `10_raw
|
|
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-
|
|
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
|
|
62
|
-
recommended way to go silent and the only
|
|
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**
|
|
64
|
+
- It pauses **every** scheduled routine — morning, evening, weekly,
|
|
65
65
|
monthly, and the activity scan — not just one of them.
|
|
66
|
-
-
|
|
67
|
-
|
|
68
|
-
- The
|
|
69
|
-
|
|
70
|
-
-
|
|
71
|
-
scheduled
|
|
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
|
|
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
|
-
|
|
94
|
-
and weekly (Fri 19:00)
|
|
95
|
-
toggle on the `/agents`
|
|
96
|
-
`/agents/weekly-review`) and click
|
|
97
|
-
appears for these system agents
|
|
98
|
-
`!stop` above instead.
|
|
99
|
-
|
|
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
|
|
105
|
-
SIGKILL after 10 seconds
|
|
106
|
-
dashboard. Use this only when you
|
|
107
|
-
temporary pause that survives across
|
|
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-
|
|
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
|
|
58
|
-
daemon
|
|
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
|
-
|
|
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
|
|
101
|
-
|
|
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 `*`
|
|
119
|
-
|
|
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
|
|
139
|
-
|
|
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-
|
|
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
|
-
|
|
69
|
-
step.
|
|
70
|
-
jumps straight to the Customize Rules step so you can refine the
|
|
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
|
|
81
|
-
|
|
82
|
-
**Customize Rules
|
|
83
|
-
skippable and
|
|
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-
|
|
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
|
-
|
|
57
|
-
|
|
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
|
|
69
|
-
back to whatever subscription login the backend's CLI already
|
|
70
|
-
the auth-health card on `/settings/models` flags this so you
|
|
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-
|
|
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
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
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
|
|
114
|
-
|
|
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.
|