Typeless free trial expired? Switch to a new account and keep all your words. One command. Zero hassle.
Typeless learns how you speak through a personal dictionary. Losing it when switching accounts sucks. This tool makes sure you never lose a single word.
Old account (26 words) ──export──► JSON ──import──► New account (26 words)
- 📤 Exports your entire Typeless dictionary (words, languages, categories)
- 🔑 Logs into a new Typeless account automatically (headless browser)
- 📥 Imports every word into the new account, skipping duplicates
- ✅ Verifies the migration — word count in, word count out
You never open a browser. The script does all the clicking. You just provide an email and a verification code.
# Export from current account (must be logged in on this Mac):
bash scripts/export-dictionary.sh
cp references/typeless-dictionary-export.json /tmp/source-dictionary.json
# Switch to new account (you'll be asked for a 6-digit code):
bash scripts/switch-account.sh --email <your-new-email>
# Import your dictionary:
bash scripts/import-dictionary.sh --input /tmp/source-dictionary.json
# Done. Verify:
bash scripts/export-dictionary.shNot logged in? Run switch-account.sh with your current email first.
Built as a skill for AI agents (Kiro, OpenClaw, etc.). The agent runs everything — you just answer two questions:
- 📧 "What email for the new account?"
- 🔢 "What's the 6-digit code?"
That's it. See SKILL.md for the full agent workflow.
- macOS or Windows with Typeless desktop app installed
- Node.js 18+
- An email that can receive verification codes
⚠️ Google / Apple sign-in users: The script only supports email login. Log into your current account via the Typeless desktop app first (Google/Apple auth), then run the export. The script reads the local session directly.
| Provider | Status | Notes |
|---|---|---|
| Gmail | ✅ | Recommended |
| Outlook / Hotmail | ✅ | |
| QQ Mail | ✅ | 国内用户推荐 |
| 163 Mail | ✅ | |
| Custom domain (Cloudflare catch-all) | ✅ | Best for automation |
Gmail +tag (user+tag@gmail.com) |
❌ | Typeless rejects + in emails |
DuckDuckGo (@duck.com) |
❌ | Forwarding breaks DKIM; emails silently dropped |
| Disposable email (mail.tm, etc.) | ❌ | Detected and blocked |
- Backs up the local Typeless state to
/tmp - Clears the local Typeless login state and cached quota/request state
- Clears Electron session/cache files that can survive a simple logout
- Overwrites Typeless's Keychain device identifier with a fresh UUID
- Opens a headless Chromium browser to the Typeless signup page
- Fills in your email, submits
- You provide the 6-digit verification code
- Script captures tokens from browser, writes encrypted local session
Same encryption Typeless uses. The desktop app picks up the new session on next launch.
On macOS, the helper scripts look for Typeless in /Applications/Typeless.app first and then ~/Applications/Typeless.app. Set TYPELESS_APP_PATH if you need to override the app location.
├── SKILL.md # AI agent skill definition
├── README.md # You are here
├── accounts.json # Account history (gitignored)
├── scripts/
│ ├── export-dictionary.sh/.ps1 # Dictionary export (macOS/Windows)
│ ├── export-dictionary.mjs # Export logic (cross-platform)
│ ├── import-dictionary.sh/.ps1 # Dictionary import (macOS/Windows)
│ ├── import-dictionary.mjs # Import logic (cross-platform)
│ ├── switch-account.sh/.ps1 # Account switcher (macOS/Windows)
│ ├── switch-account.mjs # Switcher logic (cross-platform)
│ ├── reset-device-macos.sh # Device reset (macOS)
│ └── reset-device-windows.ps1 # Device reset (Windows)
└── references/
├── extract-dictionary.md # Technical deep-dive
└── typeless-dictionary-export.* # Export artifacts (gitignored)
Default flow is manual code input. switch-account.mjs has a codeResolver extension point for full automation — see the file header.
Ideas:
- Cloudflare Email Worker → KV → API query
- IMAP client polling a mailbox
- Any programmatic inbox reader
Reported 2026-04-13 and reproduced locally on 2026-04-25 after restarting Typeless. The old reset flow only deleted user-data.json, app-storage.json login keys, and a legacy Keychain device identifier. That is not enough for recent Typeless builds because the app also reuses Electron/Chromium session state and updater/cache state.
What changed:
reset-device-macos.shnow creates a backup before cleanup.- The reset flow clears login/quota/request state plus Electron Cookies, Local Storage, Session Storage, Trust Tokens, SharedStorage, Network state, and app caches.
- The reset flow also clears
typeless-updater/ Squirrel caches to remove bad pending updates that can cause repeated macOS signature-validation failures. - The Keychain item is overwritten, not merely deleted, because Typeless 1.1.0 can recreate the same UUID after deletion.
If the error persists after the stronger reset, it is likely server-side account/device-slot state rather than a local-only cache problem.
MIT
Typeless 免费额度用完了?换个号,词典一个不丢。一条命令搞定。
Typeless 通过个人词典学习你的说话习惯。换号丢词典太亏了。这个工具让你一个词都不会丢。
旧账号 (26个词) ──导出──► JSON ──导入──► 新账号 (26个词)
- 📤 导出完整词典(词条、语言、分类)
- 🔑 自动登录新账号(无头浏览器,不用你动手)
- 📥 导入所有词条,自动跳过重复
- ✅ 验证迁移结果
全程不需要打开浏览器。 脚本帮你点完所有按钮,你只需要提供邮箱和验证码。
# 导出当前账号词典(需要本机已登录):
bash scripts/export-dictionary.sh
cp references/typeless-dictionary-export.json /tmp/source-dictionary.json
# 切换到新账号(会提示输入验证码):
bash scripts/switch-account.sh --email <新邮箱>
# 导入词典:
bash scripts/import-dictionary.sh --input /tmp/source-dictionary.json
# 验证:
bash scripts/export-dictionary.sh没登录?先用当前邮箱跑一次 switch-account.sh 登录。
本项目可作为 AI Agent(Kiro、OpenClaw 等)的 skill 使用。Agent 负责所有操作,你只需要回答两个问题:
- 📧 "新账号用什么邮箱?"
- 🔢 "验证码是多少?"
完整 Agent 工作流见 SKILL.md。
- macOS 或 Windows,已安装 Typeless 桌面应用
- Node.js 18+
- 一个能收验证码的邮箱
⚠️ Google / Apple 登录用户: 脚本仅支持邮箱登录。请先在 Typeless 桌面应用中手动完成 Google/Apple 登录,等同步完成后再运行导出。
| 邮箱 | 状态 | 备注 |
|---|---|---|
| Gmail | ✅ | 推荐 |
| Outlook / Hotmail | ✅ | |
| QQ 邮箱 | ✅ | 国内用户推荐 |
| 163 邮箱 | ✅ | |
| 自定义域名(Cloudflare 全收) | ✅ | 适合自动化使用 |
Gmail +tag(user+tag@gmail.com) |
❌ | Typeless 拒绝含 + 的邮箱 |
DuckDuckGo(@duck.com) |
❌ | 转发破坏 DKIM,验证码被静默丢弃 |
| 临时邮箱(mail.tm 等) | ❌ | 被识别并屏蔽 |
- 先把本地 Typeless 状态备份到
/tmp - 清除本地 Typeless 登录态和已缓存的 quota/request 状态
- 清理简单登出后仍可能复用的 Electron session/cache 文件
- 把 Keychain / Credential Manager 中的 Typeless 设备标识覆盖为新的 UUID
- 无头浏览器打开 Typeless 注册页面
- 自动填入邮箱并提交
- 你提供 6 位验证码
- 脚本捕获 token,写入加密的本地登录态
使用与 Typeless 相同的加密方式,桌面应用下次启动时自动识别新会话。
在 macOS 上,脚本会优先查找 /Applications/Typeless.app,其次查找 ~/Applications/Typeless.app。如需覆盖默认路径,可设置环境变量 TYPELESS_APP_PATH。
默认需要手动输入验证码。switch-account.mjs 提供了 codeResolver 扩展点——详见文件顶部注释。
可能的实现:
- Cloudflare Email Worker → KV → API 查询
- IMAP 客户端轮询邮箱
- 任何能编程读取收件箱的服务
2026-04-13 首次报告,2026-04-25 在本机重启 Typeless 后复现。旧 reset 流程只删除 user-data.json、app-storage.json 登录字段和旧版 Keychain 设备标识;这对新版 Typeless 不够,因为 Electron/Chromium session、网络状态、缓存和 updater 状态也会被复用。
已修复:
reset-device-macos.sh会先自动备份。- reset 流程会清理登录/quota/request 状态,以及 Cookies、Local Storage、Session Storage、Trust Tokens、SharedStorage、Network state 和 app caches。
- reset 流程会清理
typeless-updater/ Squirrel 缓存,避免坏的待更新包反复触发 macOS 签名校验失败。 - Keychain 项会被覆盖而不是单纯删除,因为 Typeless 1.1.0 在删除后可能重建同一个 UUID。
如果强 reset 后仍报错,问题大概率已经落在服务端账号/设备槽状态,而不是本地缓存。
MIT