Skip to content

docs(mobile): record why jotai stays on 2.x #8204

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
iscekic wants to merge 3 commits into
base: main
Choose a base branch
from
+10 −0
Open

docs(mobile): record why jotai stays on 2.x #8204

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
bb1a0b7
docs(mobile): record why jotai stays on 2.x
iscekic Oct 20, 2026
1a14c4d
docs(mobile): tighten the jotai dependency note
iscekic Oct 20, 2026
e8745e5
docs(mobile): name a reachable jotai-minidb trigger
iscekic Oct 20, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 10 additions & 0 deletions apps/mobile/AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -38,6 +38,16 @@ git diff --check

- Install with `npx expo install <package>` (or `--dev`), never `pnpm add`.
- After dependency changes, run `pnpx expo-doctor` and fix every issue.
- `jotai` stays on 2.x for now, and the four pins move together: `apps/mobile`,
`apps/web`, `apps/extension` and `packages/cloud-agent-sdk`. The SDK creates
the session atoms and each app reads them through its own jotai hooks, so a
partial bump fails `typecheck`: a 2.x `Atom` is not assignable to the 3.x
type because its `read` options still require `setSelf`, which 3.x removed
(mobile alone reports 153 such errors). `apps/web` cannot move first while
`jotai-minidb@0.0.8` (the latest release) imports `atomFamily` from
`jotai/vanilla/utils` and calls `setSelf`; both are gone in 3.x. Revisit as
soon as `jotai-minidb` ships a release that supports `jotai` 3; 3.0.1 already
clears `minimumReleaseAge`.
- `@kilocode/kilo-chat-hooks` is copied, not symlinked. After editing it:

```bash
Expand Down
Loading