npm install
npm run devscripts/dev-setup.mjs creates apps/agent/.dev.vars (git-ignored) with
TALORYS_ENV=development, the mock AI provider, a local password hash and a
session secret and a Web Push key pair (browsers allow push on localhost). Set TALORYS_DEV_PASSWORD before the first run to choose the
password, or delete the file to regenerate. A file made before push existed gets a
Web Push key pair added on the next run; nothing else in it changes.
npx wrangler login
npm run dev:remote-ai -w @talorys/agent # instead of dev:agentremember …, add task …, add note …, complete task …, list tasks,
remind me in N minutes to …, search …. Anything else gets an echo reply.
With the mock AI provider (or demo mode), semantic recall
uses the mock embedder instead of Workers AI: a deterministic hashed bag of
words plus a small concept table (car/tesla/oil, vegetarian/dinner,
peanut/allergic, city/denver, heights/mountains/knee). It exercises the full
code path offline but does not produce real semantic similarity. The Settings
card shows "Mock (local dev)" as the embedder. Use dev:remote-ai to try real
embeddings.
- Create
apps/agent/src/tools/<name>.tswithdefineTool({...})entries. - Register them in
apps/agent/src/tools/index.ts. - Add tests in
apps/agent/test/.
Append to MIGRATIONS in apps/agent/src/db/migrations.ts with the next
version. Never edit existing entries or drop owner data.