@aitne-sh/aitne 0.1.6 → 0.1.8

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 (222) hide show
  1. package/README.md +195 -1029
  2. package/agent-assets/agent-profiles/_safety.md +49 -17
  3. package/agent-assets/agent-profiles/profile-importer.md +1 -1
  4. package/agent-assets/agent-profiles/routine.md +4 -3
  5. package/agent-assets/docs/concepts/agent-day.md +6 -1
  6. package/agent-assets/docs/concepts/auth-health.md +10 -1
  7. package/agent-assets/docs/concepts/backends-and-tiers.md +74 -40
  8. package/agent-assets/docs/concepts/costs-and-quotas.md +25 -5
  9. package/agent-assets/docs/concepts/delegated-mode.md +147 -68
  10. package/agent-assets/docs/concepts/memory-model.md +9 -4
  11. package/agent-assets/docs/concepts/observations.md +13 -1
  12. package/agent-assets/docs/concepts/process-keys.md +20 -5
  13. package/agent-assets/docs/concepts/routines.md +38 -20
  14. package/agent-assets/docs/concepts/safety-model.md +30 -13
  15. package/agent-assets/docs/concepts/skills.md +12 -7
  16. package/agent-assets/docs/features/integrations/calendar.md +1 -1
  17. package/agent-assets/docs/features/integrations/git.md +2 -2
  18. package/agent-assets/docs/features/integrations/github.md +9 -2
  19. package/agent-assets/docs/features/integrations/mail.md +1 -1
  20. package/agent-assets/docs/features/integrations/notion.md +34 -6
  21. package/agent-assets/docs/features/integrations/obsidian.md +7 -2
  22. package/agent-assets/docs/features/lifestyle/git.md +4 -7
  23. package/agent-assets/docs/features/lifestyle/receipts.md +17 -2
  24. package/agent-assets/docs/features/lifestyle/travel-bookings.md +15 -0
  25. package/agent-assets/docs/features/lifestyle/travel-time.md +7 -1
  26. package/agent-assets/docs/features/memory-files/agent-journal.md +2 -2
  27. package/agent-assets/docs/features/memory-files/projects.md +6 -0
  28. package/agent-assets/docs/features/memory-files/roadmap.md +5 -0
  29. package/agent-assets/docs/features/memory-files/today.md +1 -0
  30. package/agent-assets/docs/features/memory-files/user-profile.md +6 -0
  31. package/agent-assets/docs/features/messaging/bang-commands.md +20 -10
  32. package/agent-assets/docs/features/messaging/discord.md +12 -1
  33. package/agent-assets/docs/features/messaging/overview.md +10 -7
  34. package/agent-assets/docs/features/messaging/slack.md +13 -1
  35. package/agent-assets/docs/features/messaging/telegram.md +7 -1
  36. package/agent-assets/docs/features/messaging/whatsapp.md +12 -1
  37. package/agent-assets/docs/features/operations/activity-and-conversations.md +2 -2
  38. package/agent-assets/docs/features/operations/approvals.md +6 -0
  39. package/agent-assets/docs/features/operations/backend-routing.md +7 -0
  40. package/agent-assets/docs/features/operations/cost-tracking.md +6 -0
  41. package/agent-assets/docs/features/operations/notifications.md +6 -0
  42. package/agent-assets/docs/features/operations/schedule-approaching.md +22 -9
  43. package/agent-assets/docs/features/routines/custom-routines.md +10 -4
  44. package/agent-assets/docs/features/routines/evening-review.md +1 -1
  45. package/agent-assets/docs/features/routines/hourly-check.md +1 -1
  46. package/agent-assets/docs/features/routines/morning-routine.md +24 -15
  47. package/agent-assets/docs/features/routines/weekly-review.md +38 -12
  48. package/agent-assets/docs/features/wiki/commands.md +11 -0
  49. package/agent-assets/docs/features/wiki/overview.md +13 -3
  50. package/agent-assets/docs/getting-started/01-what-is-this.md +32 -11
  51. package/agent-assets/docs/getting-started/02-first-steps.md +17 -4
  52. package/agent-assets/docs/getting-started/03-what-can-this-do.md +21 -11
  53. package/agent-assets/docs/getting-started/04-first-day.md +14 -0
  54. package/agent-assets/docs/glossary.md +65 -12
  55. package/agent-assets/docs/guides/add-a-custom-routine.md +12 -0
  56. package/agent-assets/docs/guides/backup-and-restore.md +16 -2
  57. package/agent-assets/docs/guides/budget-and-cost-for-wiki.md +6 -0
  58. package/agent-assets/docs/guides/build-your-wiki.md +14 -0
  59. package/agent-assets/docs/guides/change-which-model-handles-x.md +7 -0
  60. package/agent-assets/docs/guides/connect-a-new-mail-account.md +16 -0
  61. package/agent-assets/docs/guides/explore-with-trace-and-connect.md +6 -0
  62. package/agent-assets/docs/guides/import-knowledge-file.md +11 -0
  63. package/agent-assets/docs/guides/install-and-run.md +20 -4
  64. package/agent-assets/docs/guides/maintain-wiki-health.md +6 -0
  65. package/agent-assets/docs/guides/migrate-machines.md +13 -1
  66. package/agent-assets/docs/guides/multiple-wikis-for-multiple-domains.md +9 -0
  67. package/agent-assets/docs/guides/pause-the-agent.md +12 -4
  68. package/agent-assets/docs/guides/reinstall-cleanly.md +19 -4
  69. package/agent-assets/docs/guides/setup-wizard.md +20 -9
  70. package/agent-assets/docs/guides/switch-default-backend.md +10 -1
  71. package/agent-assets/docs/guides/use-an-existing-obsidian-vault.md +5 -0
  72. package/agent-assets/docs/reference/api.md +29 -1
  73. package/agent-assets/docs/reference/cli-commands.md +22 -3
  74. package/agent-assets/docs/reference/config.md +37 -5
  75. package/agent-assets/docs/reference/disallowed-tools.md +13 -0
  76. package/agent-assets/docs/reference/keyboard-shortcuts.md +13 -0
  77. package/agent-assets/docs/reference/process-keys.md +70 -20
  78. package/agent-assets/docs/reference/skills.md +27 -9
  79. package/agent-assets/docs/troubleshooting/auth-failed.md +7 -2
  80. package/agent-assets/docs/troubleshooting/dashboard-shows-degraded.md +13 -1
  81. package/agent-assets/docs/troubleshooting/fallback-keeps-firing.md +10 -0
  82. package/agent-assets/docs/troubleshooting/messaging-not-pairing.md +11 -0
  83. package/agent-assets/docs/troubleshooting/morning-routine-didnt-run.md +9 -4
  84. package/agent-assets/docs/troubleshooting/observation-not-detected.md +12 -0
  85. package/agent-assets/docs/troubleshooting/quota-exhausted.md +7 -1
  86. package/agent-assets/docs/troubleshooting/wiki-ingest-full-blocked.md +5 -0
  87. package/agent-assets/docs/troubleshooting/wiki-write-failed.md +5 -0
  88. package/agent-assets/optimizer-skills/drift-analysis/SKILL.md +1 -1
  89. package/agent-assets/optimizer-skills/skill-curation/SKILL.md +2 -2
  90. package/agent-assets/skills/agent-actions/SKILL.md +122 -0
  91. package/agent-assets/skills/attach/SKILL.md +1 -2
  92. package/agent-assets/skills/context/SKILL.md +36 -454
  93. package/agent-assets/skills/context/references/api.md +220 -0
  94. package/agent-assets/skills/context/references/required-frontmatter.md +73 -0
  95. package/agent-assets/skills/context/references/snapshot-files.md +103 -0
  96. package/agent-assets/skills/context/seeds/file-responsibilities.seed.json +1 -1
  97. package/agent-assets/skills/docs-search/SKILL.md +13 -13
  98. package/agent-assets/skills/external-services/SKILL.delegated.claude.md +5 -7
  99. package/agent-assets/skills/external-services/SKILL.delegated.codex.md +5 -7
  100. package/agent-assets/skills/external-services/SKILL.delegated.gemini.md +5 -7
  101. package/agent-assets/skills/external-services/SKILL.md +6 -259
  102. package/agent-assets/skills/external-services/SKILL.native.claude.md +1 -2
  103. package/agent-assets/skills/external-services/SKILL.native.codex.md +1 -2
  104. package/agent-assets/skills/external-services/SKILL.native.gemini.md +1 -2
  105. package/agent-assets/skills/external-services/references/calendar-apple.md +97 -0
  106. package/agent-assets/skills/external-services/references/calendar-google.md +72 -0
  107. package/agent-assets/skills/external-services/references/calendar-outlook.md +36 -0
  108. package/agent-assets/skills/external-services/references/github.md +17 -0
  109. package/agent-assets/skills/external-services/references/obsidian.md +49 -0
  110. package/agent-assets/skills/external-services/references/skills-crud.md +27 -0
  111. package/agent-assets/skills/gmail-lifestyle/SKILL.md +224 -0
  112. package/agent-assets/skills/gmail-lifestyle/references/receipts-api.md +93 -0
  113. package/agent-assets/skills/gmail-lifestyle/references/travel-bookings-api.md +75 -0
  114. package/agent-assets/skills/gmail-lifestyle/references/travel-time-api.md +59 -0
  115. package/agent-assets/skills/mail/SKILL.delegated.claude.md +1 -1
  116. package/agent-assets/skills/mail/SKILL.delegated.codex.md +1 -1
  117. package/agent-assets/skills/mail/SKILL.delegated.gemini.md +1 -1
  118. package/agent-assets/skills/mail/SKILL.md +9 -114
  119. package/agent-assets/skills/mail/SKILL.native.claude.md +1 -1
  120. package/agent-assets/skills/mail/SKILL.native.codex.md +1 -1
  121. package/agent-assets/skills/mail/SKILL.native.gemini.md +1 -1
  122. package/agent-assets/skills/mail/references/api.md +108 -0
  123. package/agent-assets/skills/mail/references/examples.md +70 -0
  124. package/agent-assets/skills/mail/references/providers.md +8 -8
  125. package/agent-assets/skills/managed-tasks/SKILL.md +472 -0
  126. package/agent-assets/skills/managed-tasks/references/errors.md +70 -0
  127. package/agent-assets/skills/managed-tasks/references/output-path.md +75 -0
  128. package/agent-assets/skills/managed-tasks/references/recurrence-rule.md +86 -0
  129. package/agent-assets/skills/management-policy/SKILL.md +33 -105
  130. package/agent-assets/skills/management-policy/references/policy-workflow.md +101 -0
  131. package/agent-assets/skills/notify/SKILL.md +6 -78
  132. package/agent-assets/skills/notify/references/priority.md +60 -0
  133. package/agent-assets/skills/notion/SKILL.delegated.claude.md +1 -1
  134. package/agent-assets/skills/notion/SKILL.delegated.codex.md +1 -1
  135. package/agent-assets/skills/notion/SKILL.delegated.gemini.md +1 -1
  136. package/agent-assets/skills/notion/SKILL.md +6 -10
  137. package/agent-assets/skills/notion/SKILL.native.claude.md +1 -2
  138. package/agent-assets/skills/notion/SKILL.native.codex.md +1 -2
  139. package/agent-assets/skills/notion/SKILL.native.gemini.md +1 -2
  140. package/agent-assets/skills/observations/SKILL.md +1 -6
  141. package/agent-assets/skills/project-doc/SKILL.md +1 -5
  142. package/agent-assets/skills/reading/SKILL.md +2 -2
  143. package/agent-assets/skills/roadmap/SKILL.md +37 -135
  144. package/agent-assets/skills/roadmap/references/api.md +100 -0
  145. package/agent-assets/skills/roadmap/references/cross-check.md +73 -0
  146. package/agent-assets/skills/roadmap/references/migration.md +56 -0
  147. package/agent-assets/skills/roadmap/references/preparation-timeline.md +2 -2
  148. package/agent-assets/skills/schedule/SKILL.md +52 -88
  149. package/agent-assets/skills/schedule/references/batch.md +93 -0
  150. package/agent-assets/skills/schedule/references/errors.md +214 -0
  151. package/agent-assets/skills/schedule/references/model-selection.md +96 -0
  152. package/agent-assets/skills/schedule/references/recurrence-rule.md +86 -0
  153. package/agent-assets/skills/schedule/references/recurring.md +185 -0
  154. package/agent-assets/skills/scheduled-managed-task/SKILL.md +13 -15
  155. package/agent-assets/skills/today/SKILL.md +27 -57
  156. package/agent-assets/skills/today/references/agent-plan-lifecycle.md +113 -0
  157. package/agent-assets/skills/user-interview/SKILL.md +12 -59
  158. package/agent-assets/skills/user-interview/references/op-briefing.md +51 -0
  159. package/agent-assets/skills/user-interview/references/op-morning.md +59 -0
  160. package/agent-assets/skills/user-interview/references/sweep-and-fallback.md +1 -1
  161. package/agent-assets/skills/user-profile/SKILL.md +43 -63
  162. package/agent-assets/skills/user-profile/references/character-preferences.md +83 -0
  163. package/agent-assets/skills/user-profile/seeds/topic-files.seed.json +28 -0
  164. package/agent-assets/skills/wiki/wiki-ask/SKILL.md +0 -1
  165. package/agent-assets/skills/wiki/wiki-compile/SKILL.md +0 -1
  166. package/agent-assets/skills/wiki/wiki-connect/SKILL.md +0 -1
  167. package/agent-assets/skills/wiki/wiki-graduate/SKILL.md +0 -1
  168. package/agent-assets/skills/wiki/wiki-ingest/SKILL.md +0 -1
  169. package/agent-assets/skills/wiki/wiki-lint/SKILL.md +0 -1
  170. package/agent-assets/skills/wiki/wiki-trace/SKILL.md +0 -1
  171. package/agent-assets/skills/wiki/wiki-vault-rules/SKILL.md +0 -1
  172. package/agent-assets/system-prompts/routine-fetch-window.md +68 -0
  173. package/agent-assets/system-prompts/skill-index-instruction.md +26 -0
  174. package/agent-assets/task-flows/_partials/calendar-acquire.google_calendar.md +18 -11
  175. package/agent-assets/task-flows/_partials/calendar-acquire.outlook_calendar.md +16 -9
  176. package/agent-assets/task-flows/_partials/capture-user-info.md +24 -0
  177. package/agent-assets/task-flows/_partials/confirm-subflow.md +68 -0
  178. package/agent-assets/task-flows/_partials/dm-intent.long-horizon.md +35 -0
  179. package/agent-assets/task-flows/_partials/dm-intent.project.md +391 -0
  180. package/agent-assets/task-flows/_partials/mail-acquire.gmail.md +20 -11
  181. package/agent-assets/task-flows/_partials/mail-acquire.outlook_mail.md +17 -9
  182. package/agent-assets/task-flows/_partials/notion-acquire.notion.md +18 -12
  183. package/agent-assets/task-flows/knowledge.import.md +1 -1
  184. package/agent-assets/task-flows/message.received.dm.md +13 -15
  185. package/agent-assets/task-flows/message.received.dm_first.md +10 -14
  186. package/agent-assets/task-flows/routine.custom.md +3 -1
  187. package/agent-assets/task-flows/routine.evening_review.md +39 -163
  188. package/agent-assets/task-flows/routine.fetch_window.md +17 -12
  189. package/agent-assets/task-flows/routine.hourly_check.md +16 -8
  190. package/agent-assets/task-flows/routine.hourly_check.triage.md +1 -1
  191. package/agent-assets/task-flows/routine.monthly_review.md +46 -4
  192. package/agent-assets/task-flows/routine.morning_routine_journal.md +113 -0
  193. package/agent-assets/task-flows/routine.morning_routine_today.md +673 -0
  194. package/agent-assets/task-flows/routine.roadmap_refresh.md +60 -15
  195. package/agent-assets/task-flows/routine.user_profile_sweep.md +9 -10
  196. package/agent-assets/task-flows/routine.weekly_review.md +285 -70
  197. package/agent-assets/task-flows/scheduled.dm.md +8 -8
  198. package/agent-assets/task-flows/scheduled.task.md +5 -5
  199. package/agent-assets/task-flows/setup.initial.md +165 -245
  200. package/agent-assets/task-flows/wiki.ingest_url.md +1 -1
  201. package/agent-assets/templates/_manifest.json +7 -7
  202. package/agent-assets/templates/dossiers/_index.md +1 -1
  203. package/agent-assets/templates/rules/journal-format.md +145 -38
  204. package/agent-assets/templates/user/expertise.md +4 -2
  205. package/agent-assets/templates/user/goals.md +4 -2
  206. package/agent-assets/templates/user/people.md +8 -2
  207. package/agent-assets/templates/user/personal.md +4 -2
  208. package/agent-assets/templates/user/work.md +4 -2
  209. package/bin/aitne.mjs +8 -1
  210. package/package.json +4 -4
  211. package/scripts/commands/doctor.mjs +52 -0
  212. package/scripts/commands/run-now.mjs +202 -0
  213. package/scripts/commands/verify.mjs +264 -0
  214. package/agent-assets/docs/features/routines/monthly-review.md +0 -65
  215. package/agent-assets/skills/management-task-modify/SKILL.md +0 -203
  216. package/agent-assets/skills/management-task-register/SKILL.md +0 -330
  217. package/agent-assets/skills/management-task-stop/SKILL.md +0 -166
  218. package/agent-assets/skills/receipts/SKILL.md +0 -134
  219. package/agent-assets/skills/travel/SKILL.md +0 -132
  220. package/agent-assets/skills/travel-time/SKILL.md +0 -158
  221. package/agent-assets/task-flows/routine.morning_routine.md +0 -322
  222. package/agent-assets/task-flows/routine.morning_routine_initial.md +0 -204
@@ -12,16 +12,22 @@ summary: |
12
12
  Walks through the setup wizard step by step: profile, time axis,
13
13
  backend selection and API-key registration, messaging pairing,
14
14
  integrations, execution mode.
15
+ section: setup-wizard
15
16
  tags:
17
+ - core
18
+ - guide
19
+ - getting-started
16
20
  - setup
21
+ - backends
17
22
  status: stable
18
23
  ask_examples:
19
24
  - What does each setup step do?
20
25
  - Can I rerun the setup wizard?
21
26
  - Do I have to connect every integration to start?
27
+ - Where do I paste my API key?
22
28
  locale: en-US
23
29
  created: 2026-04-25
24
- updated: 2026-05-04
30
+ updated: 2026-05-15
25
31
  keywords:
26
32
  - setup
27
33
  - wizard
@@ -29,12 +35,16 @@ keywords:
29
35
  - cloud providers
30
36
  - bedrock
31
37
  - vertex
38
+ - foundry
39
+ - azure-openai
40
+ - opencode
41
+ - execution mode
32
42
  related:
33
43
  - getting-started/01-what-is-this
34
44
  - getting-started/02-first-steps
35
45
  - getting-started/04-first-day
36
46
  - concepts/safety-and-execution
37
- - guides/use-cloud-providers
47
+ - concepts/backends-and-tiers
38
48
  ui_anchors:
39
49
  - /setup
40
50
  ---
@@ -49,7 +59,7 @@ the steps you have already filled in.
49
59
 
50
60
  ## Prerequisites
51
61
 
52
- - The daemon is launched (`pa start` or `pnpm start`).
62
+ - The daemon is launched (`aitne start` or `pnpm start`).
53
63
  - The dashboard is reachable at `http://localhost:3000`.
54
64
 
55
65
  ## Steps
@@ -85,9 +95,10 @@ The provider dropdown picks one of:
85
95
  (Vertex AI).
86
96
 
87
97
  For non-direct providers, the form re-renders with the cloud-specific
88
- fields (region, project ID, AWS auth mode, deployment names, …). See
89
- [Use a Cloud Provider for Models](use-cloud-providers.md) for the
90
- full per-provider field reference.
98
+ fields (region, project ID, AWS auth mode, deployment names, …). Refer
99
+ to your cloud provider's enterprise / Vertex / Bedrock documentation
100
+ for the value of each field; the daemon stores them in the OS keychain
101
+ and mirrors the matching env vars into the backend subprocess.
91
102
 
92
103
  API key (or cloud-provider) registration is the recommended path
93
104
  because it is what Anthropic, OpenAI, and Google document for
@@ -120,8 +131,8 @@ Each integration is independently re-runnable from `/connections`.
120
131
 
121
132
  ### Step 7 — Routines
122
133
 
123
- Toggle which routines are enabled (morning, evening, weekly, monthly,
124
- hourly check) and pick the hours.
134
+ Toggle which routines are enabled (morning, evening, weekly, hourly
135
+ check) and pick the hours.
125
136
 
126
137
  ## Verification
127
138
 
@@ -131,7 +142,7 @@ hourly check) and pick the hours.
131
142
 
132
143
  ## If It Fails
133
144
 
134
- - A step that errors: check `pa logs` for the underlying daemon
145
+ - A step that errors: check `aitne logs` for the underlying daemon
135
146
  message. Most failures are credential shape issues.
136
147
  - A backend that won't authenticate: see [Auth Failed](../troubleshooting/auth-failed.md).
137
148
 
@@ -3,6 +3,10 @@ schema_version: 1
3
3
  slug: guides/switch-default-backend
4
4
  title: Switch the Default Backend
5
5
  id: switch-default-backend
6
+ aliases:
7
+ - switch backend
8
+ - change main backend
9
+ - switch claude codex gemini opencode
6
10
  category: guides
7
11
  summary: |
8
12
  Change the main backend the agent uses for most ProcessKeys, plus
@@ -12,6 +16,7 @@ section: switch-default-backend
12
16
  tags:
13
17
  - guide
14
18
  - backends
19
+ - operations
15
20
  status: stable
16
21
  ask_examples:
17
22
  - How do I switch from Claude to Codex?
@@ -19,11 +24,15 @@ ask_examples:
19
24
  locale: en-US
20
25
  created: 2026-04-25
21
26
  updated: 2026-05-04
27
+ keywords:
28
+ - main backend
29
+ - switch backend
30
+ - default backend
31
+ - PUT /api/backends/main
22
32
  related:
23
33
  - concepts/backends-and-tiers
24
34
  - features/operations/backend-routing
25
35
  - guides/change-which-model-handles-x
26
- - guides/use-cloud-providers
27
36
  ---
28
37
 
29
38
  # Switch the Default Backend
@@ -25,6 +25,11 @@ ask_examples:
25
25
  locale: en-US
26
26
  created: 2026-05-12
27
27
  updated: 2026-05-12
28
+ keywords:
29
+ - external vault
30
+ - existing obsidian vault
31
+ - point at vault
32
+ - wiki external
28
33
  related:
29
34
  - features/wiki/overview
30
35
  - guides/build-your-wiki
@@ -3,6 +3,11 @@ schema_version: 1
3
3
  slug: reference/api
4
4
  title: API Reference
5
5
  id: api-ref
6
+ aliases:
7
+ - api reference
8
+ - rest api
9
+ - http api
10
+ - daemon api
6
11
  category: reference
7
12
  summary: |
8
13
  Aitne's daemon serves a Hono HTTP API on PA_API_PORT
@@ -12,13 +17,24 @@ section: api
12
17
  tags:
13
18
  - reference
14
19
  - api
20
+ - core
21
+ - operations
15
22
  status: stable
16
23
  ask_examples:
17
24
  - What endpoints does the daemon expose?
18
25
  - How do I read context files via API?
19
26
  locale: en-US
20
27
  created: 2026-04-25
21
- updated: 2026-04-25
28
+ updated: 2026-05-16
29
+ keywords:
30
+ - API
31
+ - REST
32
+ - endpoint
33
+ - Hono
34
+ - PA_API_PORT
35
+ - bearer token
36
+ - /api
37
+ - /api/wiki
22
38
  related:
23
39
  - reference/config
24
40
  ---
@@ -39,6 +55,7 @@ related:
39
55
  | Reading | `/api/books` | Reading list CRUD. |
40
56
  | Lifestyle | `/api/receipts`, `/api/travel-bookings`, `/api/travel-time` | Lifestyle data. |
41
57
  | Docs | `/api/docs/*` | Docs corpus + QA pipeline. |
58
+ | Wiki | `/api/wiki/*` | Wiki workspaces, files, search (FTS5), index, estimate, compile preview, reindex. |
42
59
  | Dashboard | `/api/dashboard/*` | Dashboard config + state. |
43
60
  | SSE | `/api/chat/stream`, `/api/events/stream` | SSE streams. |
44
61
  | Health | `/api/health`, `/api/metrics` | Daemon liveness / metrics. |
@@ -46,6 +63,17 @@ related:
46
63
 
47
64
  Auth: bearer token written to the OS keychain at first launch.
48
65
 
66
+ ## Wiki — Phase 4 endpoints
67
+
68
+ All wiki routes require an `x-process-key` header. Search and read endpoints accept DM-tier keys (`message.dm`, `message.mention`, `dashboard.chat`); writes and operator-level endpoints require `wiki.*` keys.
69
+
70
+ | Method | Path | Purpose |
71
+ |---|---|---|
72
+ | GET | `/api/wiki/:ws/search?q=<term>&kind=fts\|grep&layer=<l>&limit=<n>` | Search the workspace. Default `kind=fts` (SQLite FTS5). `kind=grep` is the legacy substring fallback; empty queries automatically fall back to grep so callers can enumerate the vault. |
73
+ | POST | `/api/wiki/:ws/reindex` | Operator escape hatch: rebuild the FTS5 index from disk. Requires a wiki-tier process key. |
74
+ | GET | `/api/wiki/:ws/compile/preview?mode=incremental\|full` | Dry-run preview of `!compile`. Returns the predicted touch set (added / modified / unchanged), scaled cost estimate, and estimated duration. No agent session runs. |
75
+ | GET | `/api/wiki/:ws/estimate?strategy=per-file\|flat` | Cost estimate for `!compile full`. Default `per-file` returns a token-level estimate (script-aware char→token approximation) with a top-N breakdown; `flat` returns the legacy P2 heuristic. |
76
+
49
77
  ## Related
50
78
 
51
79
  - [Config](config.md)
@@ -3,13 +3,21 @@ schema_version: 1
3
3
  slug: reference/cli-commands
4
4
  title: CLI Commands
5
5
  id: cli-commands
6
+ aliases:
7
+ - cli
8
+ - commands
9
+ - aitne cli
10
+ - pnpm scripts
6
11
  category: reference
7
12
  summary: |
8
13
  Lookup table for the aitne / pnpm commands that drive the daemon and
9
14
  dashboard, plus the environment variables that override defaults.
15
+ section: cli
10
16
  tags:
11
- - cli
17
+ - core
12
18
  - reference
19
+ - cli
20
+ - operations
13
21
  status: stable
14
22
  ask_examples:
15
23
  - What command starts the daemon?
@@ -17,17 +25,25 @@ ask_examples:
17
25
  - How do I tail the daemon log?
18
26
  - Where does Aitne put its data?
19
27
  - How do I see what the agent has been doing?
28
+ - How do I check my install with aitne doctor?
20
29
  locale: en-US
21
30
  created: 2026-04-27
22
- updated: 2026-04-27
31
+ updated: 2026-05-15
23
32
  keywords:
24
33
  - aitne start
25
34
  - aitne stop
35
+ - aitne restart
36
+ - aitne status
26
37
  - aitne logs
27
38
  - aitne doctor
28
39
  - aitne audit
40
+ - aitne setup
41
+ - aitne open
42
+ - aitne update
43
+ - aitne uninstall
29
44
  - pnpm start
30
45
  - PA_DATA_DIR
46
+ - PA_API_PORT
31
47
  related:
32
48
  - guides/install-and-run
33
49
  - guides/reinstall-cleanly
@@ -126,11 +142,14 @@ lives under `PA_DATA_DIR`, **not** inside the repo.
126
142
  ~/.personal-agent/
127
143
  ├── data/personal_agent.db # SQLite (sessions, actions, observations, FTS)
128
144
  ├── context/ # Markdown memory the agent reads and writes
129
- │ ├── user.md
145
+ │ ├── user/profile.md # user identity + topic slices alongside
130
146
  │ ├── today.md
131
147
  │ ├── roadmap.md
148
+ │ ├── agent/journal.md
132
149
  │ ├── projects/
133
150
  │ ├── schedule/
151
+ │ ├── daily/ # Per-day archives (YYYY-MM-DD.md)
152
+ │ ├── rules/ # Management registry + policies index
134
153
  │ └── …
135
154
  ├── logs/ # Daemon and dashboard logs
136
155
  └── pids/ # Process IDs for aitne start/stop
@@ -3,23 +3,45 @@ schema_version: 1
3
3
  slug: reference/config
4
4
  title: Config Reference
5
5
  id: config-ref
6
+ aliases:
7
+ - config
8
+ - AgentConfig
9
+ - settings keys
10
+ - runtime config
6
11
  category: reference
7
12
  summary: |
8
13
  All AgentConfig fields, their types, and where each is set
9
14
  (environment, database settings table, or in-process default).
10
15
  section: config
11
16
  tags:
17
+ - core
12
18
  - reference
13
19
  - config
20
+ - operations
14
21
  status: stable
15
22
  ask_examples:
16
23
  - What configuration keys does the agent expose?
17
24
  - Where does config get loaded from?
25
+ - How do I change the day boundary?
26
+ - Which config keys are runtime-editable from the dashboard?
18
27
  locale: en-US
28
+ keywords:
29
+ - AgentConfig
30
+ - applyConfigUpdates
31
+ - dayBoundaryHour
32
+ - hourlyCheckIntervalMinutes
33
+ - quietHoursStart
34
+ - quietHoursEnd
35
+ - executeTimeoutMinutes
36
+ - autonomousDailyCostCapUsd
37
+ - allowedToolsOverride
38
+ - PA_DATA_DIR
39
+ - PA_API_PORT
19
40
  created: 2026-04-25
20
- updated: 2026-04-25
41
+ updated: 2026-05-15
21
42
  related:
22
43
  - reference/api
44
+ - reference/cli-commands
23
45
  ---
24
46
 
25
47
  # Config Reference
@@ -49,22 +71,32 @@ A subset listed in `applyConfigUpdates` is mutable at runtime via
49
71
  | `disallowedTools` | string[] | absolute-block defaults |
50
72
  | `allowedToolsOverride` | string[] | empty |
51
73
  | `autonomousDailyCostCapUsd` | number | `0` (off) |
74
+ | `hourlyCheckPrePassFreshnessMinutes` | number | freshness window for the hourly_check `harvestForGate` pre-pass (Layer 1) — skips per-integration fetch if `runtime_state.pre_pass_last_run:<key>` is fresher than this |
75
+ | `monthlyReviewEnabled` | boolean | `false` (kill switch — routine.monthly_review stays registered but does not fire by default) |
76
+ | `delegatedTaskHeavyEnabled` | boolean | `false` (Approve-tier opt-in — gates `delegated_task_heavy` ProcessKey) |
77
+ | `voiceTranscriptionEnabled` | boolean | `false` (Whisper local transcription for voice attachments) |
78
+ | `voiceTranscriptionPrimaryLanguage` | string | Whisper language code (see VOICE_LANGUAGE_FULL list) |
79
+ | `claudeExecutionPermissionMode` | `"safe"`/`"allow"` | per-backend Safe/Allow posture set in the setup wizard |
80
+ | `codexExecutionPermissionMode` | `"safe"`/`"allow"` | same; absolute-block layer overlays both modes |
81
+ | `geminiExecutionPermissionMode` | `"safe"`/`"allow"` | same |
82
+ | `opencodeExecutionPermissionMode` | `"safe"`/`"allow"` | per-backend mode for the OpenCode backend |
83
+ | `opencodeBaseUrl` | URL string | OpenCode server URL (when self-hosted) |
84
+ | `opencodeServerUsername` | string | OpenCode server username, default `"opencode"` |
52
85
 
53
86
  The runtime-mutable subset can be edited from `/settings/*`. Restart-only
54
- fields (e.g. `apiPort`) require `pa restart`.
87
+ fields (e.g. `apiPort`) require `aitne restart`.
55
88
 
56
89
  ### Routine schedule keys do not exist
57
90
 
58
- Morning, evening, weekly, and monthly routines fire at fixed times in
91
+ Morning, evening, and weekly routines fire at fixed times in
59
92
  `packages/daemon/src/core/scheduler.ts`. There is no `morningRoutineHour`,
60
- `eveningReviewHour`, `weeklyReviewDay`, or `monthlyReviewHour` config key.
93
+ `eveningReviewHour`, or `weeklyReviewDay` config key.
61
94
 
62
95
  | Routine | Trigger |
63
96
  |---|---|
64
97
  | `routine.morning_routine` | daily at `dayBoundaryHour` |
65
98
  | `routine.evening_review` | daily at `18:00` local |
66
99
  | `routine.weekly_review` | Friday `18:00` local |
67
- | `routine.monthly_review` | last day of month at `18:00` local |
68
100
 
69
101
  Only the hourly check has a configurable cadence (`hourlyCheckIntervalMinutes`)
70
102
  and an active window (`hourlyCheckActiveStartHour` / `…ActiveEndHour`).
@@ -3,6 +3,11 @@ schema_version: 1
3
3
  slug: reference/disallowed-tools
4
4
  title: Disallowed Tools (Reference)
5
5
  id: disallowed-tools-ref
6
+ aliases:
7
+ - disallowed tools
8
+ - blocked tools
9
+ - deny list
10
+ - absolute block
6
11
  category: reference
7
12
  summary: |
8
13
  The absolute-block tool patterns. Cannot be widened by config or
@@ -11,6 +16,7 @@ section: disallowed-tools
11
16
  tags:
12
17
  - reference
13
18
  - safety
19
+ - core
14
20
  status: stable
15
21
  ask_examples:
16
22
  - What can the agent never run?
@@ -18,6 +24,13 @@ ask_examples:
18
24
  locale: en-US
19
25
  created: 2026-04-25
20
26
  updated: 2026-04-26
27
+ keywords:
28
+ - disallowedTools
29
+ - deniedTools
30
+ - absolute block
31
+ - always-disallowed
32
+ - Bash(rm -rf)
33
+ - PreToolUse
21
34
  related:
22
35
  - concepts/safety-and-execution
23
36
  ---
@@ -3,6 +3,10 @@ schema_version: 1
3
3
  slug: reference/keyboard-shortcuts
4
4
  title: Keyboard Shortcuts
5
5
  id: keyboard-shortcuts
6
+ aliases:
7
+ - keyboard shortcuts
8
+ - hotkeys
9
+ - key bindings
6
10
  category: reference
7
11
  summary: |
8
12
  Keyboard shortcuts available in the dashboard. The set is small by
@@ -11,12 +15,21 @@ section: keyboard-shortcuts
11
15
  tags:
12
16
  - reference
13
17
  - dashboard
18
+ - core
14
19
  status: stable
15
20
  ask_examples:
16
21
  - What keyboard shortcuts work in the dashboard?
17
22
  locale: en-US
18
23
  created: 2026-04-25
19
24
  updated: 2026-04-25
25
+ keywords:
26
+ - shortcut
27
+ - hotkey
28
+ - Cmd+K
29
+ - Ctrl+K
30
+ - keyboard
31
+ - cmdk
32
+ - command palette
20
33
  related:
21
34
  - features/messaging/dashboard-chat
22
35
  ---
@@ -6,49 +6,99 @@ id: process-keys-ref
6
6
  aliases:
7
7
  - process key list
8
8
  - dispatch keys
9
+ - processkey reference
10
+ - routine keys
9
11
  category: reference
10
12
  summary: |
11
13
  The full list of ProcessKeys, what triggers each, and the default
12
14
  tier. Mirrors packages/shared/src/process-key.ts.
13
15
  section: process-keys
14
16
  tags:
17
+ - core
15
18
  - reference
16
19
  - dispatch
20
+ - backends
21
+ - routing
17
22
  status: stable
18
23
  ask_examples:
19
24
  - List all the ProcessKeys
20
25
  - What is the default tier for hourly check?
26
+ - Which ProcessKeys are configurable from the dashboard?
27
+ - What is routine.fetch_window used for?
21
28
  locale: en-US
29
+ keywords:
30
+ - processkey
31
+ - ProcessKey
32
+ - dispatch
33
+ - tier
34
+ - lite
35
+ - medium
36
+ - high
37
+ - routine.morning_routine
38
+ - routine.fetch_window
39
+ - message.dm
40
+ - calendar.change
41
+ - delegated_task
42
+ - gmail_classify
22
43
  created: 2026-04-25
23
- updated: 2026-04-25
44
+ updated: 2026-05-15
24
45
  related:
25
46
  - concepts/process-keys
47
+ - concepts/backends-and-tiers
48
+ - features/operations/backend-routing
26
49
  ---
27
50
 
28
51
  # ProcessKeys
29
52
 
30
53
  | ProcessKey | Trigger | Default tier | Configurable |
31
54
  |---|---|---|---|
32
- | `routine.morning_routine` | Daily at `dayBoundaryHour` (default 04:00) | heavy | yes |
33
- | `routine.morning_routine_initial` | One-shot, fired once during the setup wizard's first day | heavy | no |
34
- | `routine.evening_review` | Daily at 18:00 local (fixed) | light | yes |
35
- | `routine.weekly_review` | Friday 18:00 local (fixed) | light | yes |
36
- | `routine.monthly_review` | Last day of month, 18:00 local (fixed) | light | yes |
37
- | `routine.hourly_check` | Every `hourlyCheckIntervalMinutes` (default 60) inside the active window | light | yes |
38
- | `routine.user_profile_sweep` | Periodic agent-day summarization pass | light | no |
39
- | `routine.today_refresh` | Mid-day re-check of `today.md` | light | no |
40
- | `routine.roadmap_refresh` | Periodic roadmap re-derivation | light | no |
55
+ | `routine.morning_routine` | Daily at `dayBoundaryHour` (default 04:00). Parent envelope; LLM dispatch flows through the two stage keys below. | medium | yes |
56
+ | `routine.morning_routine_today` | Stage A of the morning-routine pipeline — today.md synthesis, schedule fan-out, profile-question pick, user-editable checks. Stage A also populates roadmap.md from a daemon-prepared `<roadmap_skeleton>` block on the first-run branch (Phase 7 retired the heavy-tier `routine.morning_routine_initial`). | medium | yes |
57
+ | `routine.morning_routine_journal` | Stage B of the morning-routine pipeline — authors `daily/<yesterday>.md` from the daemon-prepared journal skeleton. | lite | yes |
58
+ | `routine.today_refresh` | Every 4h inside the active window — drift-refresh of `today.md` | medium | yes |
59
+ | `routine.evening_review` | Daily at 18:00 local (fixed) | medium | yes |
60
+ | `routine.weekly_review` | Friday 18:00 local (fixed) | medium | yes |
61
+ | `routine.monthly_review` | Monthly cadence (gated OFF by default — kill switch `monthlyReviewEnabled` in runtime settings) | medium | no |
62
+ | `routine.hourly_check` | Every `hourlyCheckIntervalMinutes` (default 60) inside the active window | medium | yes |
63
+ | `routine.hourly_check.triage` | Stage 2 triage gate of every hourly check | lite | yes |
64
+ | `routine.fetch_window` | Pre-pass fetcher spawned before each main routine | lite | yes |
65
+ | `routine.user_profile_sweep` | Periodic agent-day profile summarization pass | medium | no |
66
+ | `routine.roadmap_refresh` | Periodic roadmap re-derivation (NOT in `ROUTINE_WINDOWS` — no `routine.fetch_window` pre-pass; the synthesis session itself drives the native-mode MCP fan-out) | medium | yes |
67
+ | `routine.skill_curation` | Background skill-curation / overlay refinement loop (cron cadence picked at `/settings/self-learning`) | medium | yes |
41
68
  | `routine.custom.<slug>` | Operator-defined recurrence (see [Custom Routines](../features/routines/custom-routines.md)) | configurable | yes |
42
- | `message.dm` | Owner DM | light | yes |
43
- | `message.mention` | @-mention in shared channel | light | yes |
44
- | `dashboard.chat` | `/chat` send | light | yes |
45
- | `dashboard.docs_qa` | Docs QA panel | light (forced) | yes (within forced light) |
46
- | `agent.task` | Future-dated agent action (recurring schedules) | light | yes |
47
- | `agent.dm_task` | DM-tone scheduled session (e.g. morning briefing) | light | yes |
48
- | `schedule.approaching` | Pre-event reminder | light | no |
49
- | `calendar.change` | Calendar event added / moved / cancelled | light | yes |
50
- | `gmail_classify` | Mail classifier inference | light | yes |
51
- | `setup` | Setup wizard one-shot | heavy | no |
69
+ | `message.dm` | Owner DM | medium | yes |
70
+ | `message.mention` | @-mention in a paired Slack channel where the agent is invited (DMs are `message.dm`; Telegram/WhatsApp groups are filtered out) | medium | yes |
71
+ | `dashboard.chat` | `/chat` send | medium | yes |
72
+ | `dashboard.docs_qa` | Docs QA panel — tier is hard-forced to medium regardless of any `message.dm` override; backend choice still inherits | medium (forced) | yes (backend only) |
73
+ | `agent.task` | Future-dated agent action (recurring schedules) | medium | yes |
74
+ | `agent.dm_task` | DM-tone scheduled session (e.g. morning briefing) | medium | yes |
75
+ | `schedule.approaching` | Pre-event reminder | medium | no |
76
+ | `calendar.change` | Calendar event added / moved / cancelled | lite | yes |
77
+ | `gmail_classify` | Mail classifier inference | lite | yes |
78
+ | `delegated_task` | Generic delegated sub-job invocation | lite | no (server-resolved) |
79
+ | `delegated_task_heavy` | Opt-in heavy variant gated by `delegatedTaskHeavyEnabled` (Approve-tier) | high | no (server-resolved) |
80
+ | `observation.summarize` | Per-observation summarizer (cost-reduction §A) | lite | yes |
81
+ | `integration_drift_sync` | Periodic drift-reconciler across connected integrations | lite | no |
82
+ | `knowledge.import` | One-shot heavy session that ingests an owner-uploaded knowledge file | medium | no |
83
+ | `setup` | One-shot setup wizard backend probe / write | medium | no |
84
+ | `git.lifecycle.poll` | Git repo poll observer | lite | yes |
85
+ | `git.push.detected` | New push on a watched git repo | lite | yes |
86
+ | `git.push.force_pushed` | Force-push detected on a watched repo | lite | yes |
87
+ | `git.branch.created` | New branch on a watched repo | lite | yes |
88
+ | `git.tag.created` | New tag on a watched repo | lite | yes |
89
+ | `git.merge_to_default` | Merge into the default branch | lite | yes |
90
+ | `git.local_ahead.stale` | Local branch ahead of remote for too long | lite | yes |
91
+ | `git.project.{init,update,refresh_architecture,retemplate}` | Project-doc lifecycle hooks for watched repos (one-shot, generative — Sonnet by default) | medium | yes |
92
+ | `github.assigned` | Issue / PR assigned to the operator | lite | yes |
93
+ | `github.pull_request.review_requested` | PR review requested | lite | yes |
94
+ | `github.workflow_run.failed` | CI run failed on a tracked repo | lite | yes |
95
+ | `github.security_alert` | Dependabot / security alert raised | lite | yes |
96
+ | `wiki.ingest_url` | URL → vault ingest (WIKI_BUILDER_DESIGN P1) | medium | yes |
97
+ | `wiki.compile` | Raw → wiki synthesis (P1) | medium | yes |
98
+ | `wiki.ask` | Q&A against the compiled wiki (P1) | medium | yes |
99
+ | `wiki.lint` | Health pass over the wiki — writes `90_meta/health/<date>.md` | medium | yes |
100
+ | `wiki.trace` | Chronological evolution of an idea across raw / wiki / outputs | medium | yes |
101
+ | `wiki.connect` | Bridges two domains — writes `30_outputs/<date>-connect-<slug>.md` | medium | yes |
52
102
 
53
103
  "Configurable" = the operator can override the backend / tier on
54
104
  `/settings/models` (i.e. the key appears in `CONFIGURABLE_PROCESS_KEYS`).
@@ -3,48 +3,67 @@ schema_version: 1
3
3
  slug: reference/skills
4
4
  title: Skills (Reference)
5
5
  id: skills-ref
6
+ aliases:
7
+ - skill index
8
+ - built-in skills
9
+ - skill registry
6
10
  category: reference
7
11
  summary: |
8
12
  Index of built-in skills bundled with Aitne. Each maps to
9
13
  a SKILL.md under agent-assets/skills/<slug>/.
10
14
  section: skills
11
15
  tags:
16
+ - core
12
17
  - reference
13
18
  - skills
14
19
  status: stable
15
20
  ask_examples:
16
21
  - List all the built-in skills
17
22
  - What does the docs-search skill do?
23
+ - What does the wiki skill do?
24
+ - How is each skill scoped?
18
25
  locale: en-US
26
+ keywords:
27
+ - skill
28
+ - skills
29
+ - SKILL.md
30
+ - skill registry
31
+ - overlay
32
+ - context skill
33
+ - mail skill
34
+ - wiki skill
35
+ - notify skill
19
36
  created: 2026-04-25
20
- updated: 2026-05-04
37
+ updated: 2026-05-15
21
38
  related:
22
39
  - concepts/skills
23
- - features/operations/skill-self-optimization
24
40
  ---
25
41
 
26
42
  # Built-in Skills
27
43
 
28
44
  | Slug | Purpose |
29
45
  |---|---|
46
+ | `agent-actions` | Read the agent action log (`agent_actions` table) for retrospective audits. |
30
47
  | `attach` | Attach a generated or downloaded file to the agent's reply when the user expects a file artifact. |
31
- | `context` | Read / write context Markdown — projects, weekly/monthly summaries, agent journal, generic context files. |
48
+ | `context` | Read / write context Markdown — projects, weekly summaries, agent journal, generic context files. |
32
49
  | `docs-search` | Read-only search and fetch over the operator-facing docs corpus. Used for `dashboard.docs_qa`. |
33
50
  | `external-services` | Call Google Calendar, the user's Obsidian vault, GitHub, or the agent Skills-management routes through the daemon proxy. |
34
- | `mail` | Unified multi-provider mail interface (Gmail, Outlook, Yahoo, iCloud) — search, label, classify. |
51
+ | `mail` | Unified multi-provider mail interface (Gmail, Outlook, Yahoo, iCloud, generic IMAP) — search, label, classify. |
52
+ | `gmail-lifestyle` | Conditional skill (gated by `gmailLifestyleActive` / `gmailLifestyleActiveForDm`). Merges travel-booking queries, calendar-event commute calculations, and receipt save-to-external-vault. |
53
+ | `managed-tasks` | Register, modify, stop, or one-off-run a Managed Task (`mt_<n>`) — a recurring agent fetch against a third-party app (Zoom / Gmail / Drive / Notion / custom MCP). Conditional skill gated by `managedTasksActive` / `managedTasksActiveForDm`. |
35
54
  | `management-policy` | Capture a durable management rule from a DM ("every morning X", "from now on when Y, do Z"). Persists to the management policy store. |
36
55
  | `notify` | Send a notification through the paired messaging app and decide whether notifying is warranted. |
37
56
  | `notion` | Read, query, search, create, update, and archive Notion pages and databases. |
38
57
  | `observations` | Drain the pending-observations queue and inspect raw external-source change records. |
58
+ | `project-doc` | Read / write per-project markdown files under `projects/<slug>.md`. |
39
59
  | `reading` | Query reading history and highlights; owns the reading-taste profile via the `books` and `reading_highlights` tables. |
40
- | `receipts` | Query and manage receipt / invoice attachments detected from Gmail; download and save to the external Obsidian vault. |
41
60
  | `roadmap` | Read / write `roadmap.md` (cross-request write lock). |
42
61
  | `schedule` | Schedule future agent wake-ups and DMs via the daemon (writes `agent_schedule` and `recurring_schedules` rows). |
62
+ | `scheduled-managed-task` | Surface and act on Managed Tasks that are due now. |
43
63
  | `today` | Read or write `today.md` — morning routines, hourly checks, DMs that need a today snapshot. |
44
- | `travel` | Query the travel-bookings store (flights, hotels, restaurants, trains). |
45
- | `travel-time` | Estimate door-to-door travel time via Google Maps; calculate departure times. |
46
64
  | `user-interview` | Manage the profile-interview queue at `agent/profile-questions.md`; ask one question at a time. |
47
65
  | `user-profile` | Record user facts — identity, people, work, expertise, habits, goals — into the `user/*` slices. |
66
+ | `wiki` | Build and maintain the personal wiki workspace — `!ingest` / `!compile` / `!ask` / `!lint` / `!trace` / `!connect`. |
48
67
 
49
68
  The source of truth is each skill's `SKILL.md` under
50
69
  `agent-assets/skills/<slug>/`. The `description` field in that file's
@@ -55,5 +74,4 @@ tables, search recipes, etc.) is also refined at runtime through
55
74
  JSON **overlays** maintained by the skill-curation loop. The seed
56
75
  files in `agent-assets/skills/` are never rewritten — overlays are
57
76
  applied at session-init by the SkillsCompiler and live under
58
- `<dataDir>/overlays/<skill>/<section-id>.json`. See
59
- [Skill Self-Optimization](../features/operations/skill-self-optimization.md).
77
+ `<dataDir>/overlays/<skill>/<section-id>.json`.
@@ -22,6 +22,11 @@ ask_examples:
22
22
  locale: en-US
23
23
  created: 2026-04-25
24
24
  updated: 2026-05-04
25
+ keywords:
26
+ - auth failed
27
+ - auth error
28
+ - subscription warning
29
+ - API key invalid
25
30
  related:
26
31
  - concepts/auth-health
27
32
  - concepts/costs-and-quotas
@@ -59,8 +64,8 @@ related:
59
64
  daemon mirrors it into `process.env` and re-probes immediately.
60
65
  4. If on the subscription fallback, the recommended fix is to
61
66
  register an API key on `/settings/models` (or one of the cloud-
62
- provider options — see
63
- [Use a Cloud Provider for Models](../guides/use-cloud-providers.md)).
67
+ provider options exposed on the same picker Bedrock / Vertex /
68
+ Foundry / Azure OpenAI / Gemini-Vertex).
64
69
  If you cannot or do not want to, run the corresponding CLI login
65
70
  (`claude`, `codex login`, `gemini auth`) and the daemon picks up
66
71
  the new credentials on the next probe. Note that this fallback