Repository navigation
FAQ
No. A new install starts on AllInOneIME Cloud: sign in, and there are 20 free requests a day. Or use the Claude API, Gemini or an OpenAI-compatible service with an API key, or Apple Intelligence on this Mac (see Settings and Configuration). Without any AI provider, @open, @note, @reminder, the @calculator plugin, snippets, @agent (needs a coding agent such as Claude Code), Settings' checks (Troubleshoot), suggestions and pinyin still work; @improve, @translate, @question, @reply and Translate as You Type need one, and changing settings in a sentence (Settings' search field, "Change: …") needs Apple Intelligence or a provider.
On a Mac with Apple Intelligence (Apple silicon, macOS 26 or later), yes: choose "Apple Intelligence (on this Mac)" under Settings → AI. It's free and nothing leaves the Mac, but the model is smaller and less accurate than the cloud models, and doesn't speak every language (not Hindi). See Settings and Configuration → Apple Intelligence on this Mac.
Yes, that's how it starts: a new install has English only, and letters are typed directly. Chinese (pinyin), Korean and Hindi are language packs you add under Settings → Input → Add… if you want them; French needs no pack. Under "Translate to" (Settings → General), pick the languages you translate into.
The app is free. Your AI provider bills you by token, to your own account; Apple Intelligence on this Mac costs nothing. Your provider is asked when you run an AI command (the action key, or an AI row picked after @ with ⏎, Tab or a click), ask @question a follow-up or refine results (⇧⏎); when Translate as You Type translates a draft (⏎); when you click Test Connection in Settings (Troubleshoot's Check sends it too, when there's a key or credentials to test); and when you pick "Change: …" in Settings' search, or Check with something in Troubleshoot's "What's wrong?", if Apple Intelligence isn't available on this Mac (or the "Change: …" is too long for it). Running the same sentence again uses the cache; the more rewrite styles, the longer the output. Autocomplete, if you turn it on (or in an app set to always before 0.6.7), asks your provider after each pause: small requests but many (a heavy day can be 1,000–2,000). Privacy → What is sent when lists every request and where it goes; see also Autocomplete.
No, from 0.7.0: type @ and whatever you want (@saf, @3*7+2, @call Bob tomorrow at 3pm, @how do I undo a commit?, a sentence to polish), and the list shows what can be done with it, the likeliest first, each row saying what ⏎ does: open Safari, put in = 23, add the reminder, ask the AI, improve the sentence. The command's name is dimmed beside each row, so you learn the names as you go; @tr still finds @translate first. The rows are worked out on this Mac, and nothing you type goes to the AI until you pick a row with ⏎, Tab, the action key or a click (an AI row may open the connection to your provider before that, with no text and no key in it). See Commands → The command list.
From 0.7.0 a digit after @ is text (@3pm, @3*7+2), and the rows carry no numbers: ↑↓ choose a row, ⏎ does it. A digit that goes on a command's name (@base64) is still part of the name, also while pinyin is being composed after @; any other digit there picks a pinyin word as always.
Yes: while the results of @improve or a prompt command are up, type what to change ("shorter", "more formal", "in Japanese") and press ⇧⏎; the new results take their place. ⏎ inserts the selected result instead, and Esc goes back to the ones before. @translate has no refine: type to edit the sentence, and ⏎ translates it again. See Commands → Refining the results.
From 0.6.4, ⇧⏎ sends what you typed after AI results (an instruction, or the next question after @question), and ⏎ always inserts the selected result. In 0.6.3, ⏎ sent it.
Yes: once @question has answered, type the next question and press ⇧⏎. The panel becomes a conversation of up to 5 rounds, and each round's answer can be inserted with its digit. See Commands → Conversations.
Yes: after the last round, or with ⌘⏎ at any time, ⌘1, ⌘2 … carry it on in a coding agent installed on this Mac, Claude or ChatGPT on the web, Gemini, or copy it as Markdown. Settings → Commands → "Continue a conversation in" picks which ones and their order. See Commands → Continuing elsewhere.
Yes: in Settings, type what you want in the search field at the top of the sidebar, such as "candidates in a column" or "use Claude", and pick the last row, "Change: …". Nothing is sent until you pick it. Each change shows old → new; Apply (⌘⏎) applies them, and Undo puts them back within 10 minutes. Keys, custom commands, extensions and plugins are set only on their own pages. See Settings and Configuration → Changing settings in a sentence.
From 0.6.5 they were Settings → Assistant, and from 0.6.7 they're in Settings itself: @config is the search field's last row, "Change: …", and @doctor is About → Troubleshoot…. They're no longer built-in commands, and a command of your own may take the names. Typed, @config or @doctor is text like any other: one @ offers what can be done with it (Improve or Translate first, Ask AI last), and ⏎ would do the first row; Esc or ⇧⏎ (or → at the end) puts it in as typed. See Settings and Configuration → What changed in 0.6.7's Settings.
From 0.6.7 Settings has seven pages, General, Input, AI, Privacy, Commands, Advanced and About, and opens on General. The Assistant page's two parts are the search field's "Change: …" and About → Troubleshoot…. The Apps page is gone: an app keeps its Insert (General → Suggestions → In these apps) and No AI (Privacy → Apps without AI), its starting input is learned, and its other settings from before still work, under General → Previous per-app settings. Nothing in config.json was changed. See Settings and Configuration → What changed in 0.6.7's Settings.
Open Settings (@settings): a problem shows at the top of its page, with a red or orange dot on that page in the sidebar, and a button that says what it does where it can fix it. About → Troubleshoot… lists every check, problems first. Type what's wrong under "What's wrong? (optional)" and click Check for the likely cause. See Settings and Configuration → Troubleshoot.
From 0.6.5 the calculator is the @calculator plugin: install it from Settings → Commands → Plugins → Browse Library…. It works offline, with the same rules as before. See Commands → @calculator.
Yes: from 0.6.5 @reply is a built-in command, which writes three replies to the message you're answering, so a custom command you had named reply was renamed @myreply. See Commands → @reply.
Yes: take a screenshot of the chat to the clipboard (⌃⇧⌘4, or WeChat's own), type @reply in your draft and press ⌃V ⏎ (the screenshot is the first row), then ⏎. The screenshot is read on this Mac and only its text is sent; the image goes nowhere. In other apps you can also select or copy the message. See Commands → @reply.
Yes, with Translate as You Type (a prototype): hold Shift for a second to turn it on, write, and ⏎ inserts the translation at once. See Translate as You Type.
Because that's where its suggestions come from: it asks the AI provider you picked in Settings → AI, the one commands use. It's off until you turn it on (an app set to always before 0.6.7 has it even with the switch off: see Autocomplete → Each app), and the switch says where the text goes ("Autocomplete (Beta) · Claude API · claude-haiku-5-5"). Each pause sends the caret's line, up to 200 characters before it in the same language and 200 after, with sensitive information hidden when that's on. Kept in memory only (gone when the input method quits): its last 20 suggestions, each with the text before and after the caret it was made for and its app, and the last 20 you waved away with Esc. Saved on this Mac, in the input method's own preferences: its counts (no text) and the apps where it stopped by itself (Settings → Privacy → Learned… forgets those apps). With Apple Intelligence picked, it stays on this Mac. With AllInOneIME Cloud picked, it uses Apple Intelligence on this Mac too, and never the Cloud's free requests. It never runs during secure input, in a password field AllInOneIME can tell (without Accessibility a few aren't told: see Installation and Troubleshooting → Permissions), in terminals, password managers or apps with No AI. See Autocomplete and Privacy.
Check that it's on (Settings → General, the input menu or the menu bar panel), that you paused at the end of a line, and that the app isn't one where it never runs (terminals, password managers, code editors, apps with No AI). In an app where you took none of the last 30 suggestions it stops by itself: Forget it in Settings → Privacy → Learned… ("Autocomplete stopped in …") to start over there. A slow model (one that always thinks, or a reasoning model) may answer too late: pick a fast one, such as Claude Haiku 5.5. Where the provider can't answer (no key, the network), it says so once per text field. See Autocomplete.
Settings → Input → Add…, under Code, and pick Python. Its pack downloads first, then a tap of Shift goes through your languages to Code ("Code (Python)"). To switch to another language, pick it in Code's section on the same page, under the chips, or in the input menu. Code has one language at a time. See Suggestions and Code → Code.
That's the @github plugin's completions, on once the plugin is installed (from 0.6.7.2): Tab inserts the issue; to leave it, keep typing (→ or Esc hides the rows). Turn them off under it in Settings → Commands → Plugins (they stay off), or turn off Suggestions in Settings → General. To insert the title, or the link too, choose in Settings → General → Insert (under Suggestions), or per app under "In these apps". See Suggestions and Code.
Fixed in 0.6.7: a key press that reached the input method twice (the same key event handed over again) was counted twice, so after #1 showed GitHub rows, 7 could leave none: the field had #17, the input method #117. Now the copy gets the first one's answer and nothing else sees it, so a key is never typed twice into a suggestion's token.
Yes, from 0.6.7: Settings → General → Magic key: #, %, &, *, +, | or ~. Commands then start with it (~translate), and @ types as usual. See Commands → The magic key.
It's turned off for now, from 0.6.7: holding right ⌥ doesn't record. Your setting (voiceInput) is kept. See Voice Input.
Yes: Settings → Commands → Add Command… → Insert text makes a snippet, such as @sig. Snippets can fill in what you type after them, the date, the clipboard, and where the caret goes. See Commands → Snippets.
Yes: Settings → Commands → Notes (@note) → Save to: Notes, a folder of Markdown files (an Obsidian vault or any folder), or Notion (with an integration token). See Commands → @note and @reminder.
In Google Chrome, yes: it takes the address and title, the field you typed in with its form or section, the selected text and what's visible in the window, never a password field or the whole page. Turn it off in Settings → Privacy → "@agent and @reply take the Chrome page along". See Commands → The page in Google Chrome.
Yes: turn on Settings → General → "Sync through iCloud". Your settings, jargon list, custom commands and the words pinyin learned sync through your own iCloud Drive; hidden words and recent questions only if you turn them on, and your API keys and passwords (through iCloud Keychain) only if you turn on "API keys and passwords". Update every Mac that syncs through iCloud: 0.6.4 can't read the custom commands once one is a snippet, and if you then add, edit or delete a custom command on a 0.6.4 Mac, its list replaces the one in iCloud and the snippets are gone from your other Macs too. See Sync through iCloud.
Only if you turn it on: Settings → General → Sync through iCloud → ⋯ → "API Keys and Passwords (iCloud Keychain)" (off by default; turning on sync alone moves no key). Then your API keys and extensions' passwords go through iCloud Keychain, end-to-end encrypted, and a key saved or replaced on one Mac is there on the others. It needs Passwords & Keychain on in System Settings → Apple Account → iCloud. With it off, keys stay in each Mac's login keychain, as before, so enter them on each Mac. Never through iCloud Drive.
- The AllInOneIME Cloud sign-in never syncs: sign in on each Mac.
- When two Macs have different keys, the one saved last wins; the other is kept in its Mac's login keychain as a "(replaced)" copy that is never used, one per key.
- Remove… on a Mac with key sync on removes the key on all your Macs that sync keys; with it off, only on this Mac. A Mac with key sync off, or still on 0.6.4, keeps its own copy, and puts it back if key sync is turned on there later.
- While keys sync,
allinoneime-cliand versions before 0.6.5 don't see them in the keychain; keys in your shell still work (for their own service). - A setting from another Mac that needs a key this Mac doesn't have (a provider, say) isn't applied, and Troubleshoot says so.
See Sync through iCloud → API keys and passwords.
Yes: the interface comes in English, Simplified Chinese, Traditional Chinese, Japanese, Korean, German, French, Spanish and Portuguese (Brazil). It follows your Mac's preferred languages, or pick one in Settings → General → "Interface language". See Settings and Configuration → Interface language.
Yes: select it, type @improve, @translate or @question and press ⏎; the result you pick replaces the selection. See Commands → On the selected text.
Type @question with nothing after it: your last 5 questions (or conversations) are listed, and picking one shows its saved answer without going online (⌘R asks again; it was R up to 0.6.3). Settings → Privacy → "Remember recent questions" turns this off.
Yes: click a row of the candidate panel, as you'd press its digit (or ⏎ on it, after @). The row under the pointer is highlighted. The panel never takes the focus, so you keep typing in the same field.
Yes, from 0.7.0, while you type pinyin: right-click it (or Control-click it), or highlight it and press ⌃⌦ (⌃Fn⌫ on a laptop keyboard). It's removed for good: it no longer comes up as a candidate, whatever you type, until you bring it back. Any candidate can be removed: a word the input method learned, a phrase you made by picking characters one by one, a word of the dictionary, an emoji, and the English words among the candidates (by their letters: an English word removed isn't learned again, and stays on your list of English words, added or learned). What pinyin learned of it from your choices is forgotten too; an emoji or another candidate that comes with a word is only removed, the word staying as it was. A longer phrase or a sentence with the word in it still comes up. Nothing is put in, and you go on typing.
Settings → Input → Chinese (pinyin) → Removed candidates lists them, the newest first; ✕ brings one back. Adding an English word again in Settings → Input → English Words brings it back too. They sync through iCloud with the learned words.
Pinyin learns English words: the same letters put in as typed twice while typing pinyin, and, from 0.6.7, a word typed twice in English mode (after a tap of Shift). Nothing is sent anywhere for it; with Sync through iCloud on, the words learned sync through your own iCloud Drive. Remove a word with ✕ under English Words (Settings → Input, in English's section, or Chinese's without English), or turn off Settings → Privacy → "Learn English words". See Settings and Configuration → English words in pinyin.
Yes, from 0.6.7: Settings → Input → Chinese (pinyin) → Personal Dictionaries → Import or Update…, with a UTF-8 Rime .dict.yaml file (each entry its words, the pinyin with spaces between syllables, and an optional weight, separated by tabs). Pinyin is deployed again by itself; it stays on this Mac. See Settings and Configuration → Personal dictionaries.
Yes, from 0.7.0: Settings → Input → Chinese (pinyin) → Characters → Traditional (Taiwan), with Taiwan's words too (ruanjian → 軟體), or Traditional (Hong Kong). Until you pick one it follows your Mac's preferred languages, so a Mac in Traditional Chinese types Traditional. The AI keeps to your characters too: @improve polishes Traditional in Traditional, @translate doesn't translate it into Traditional Chinese, and @reply answers Chinese in it. Zhuyin (注音) is planned. See Settings and Configuration → Traditional Chinese.
From 0.6.3 that's the default (Horizontal), like the system's own input methods: ← → choose, ↑↓ or - = turn the page. Choose Vertical under Settings → Advanced → "Candidate layout" for a column.
In a command, ⏎ runs the command, and ⇧⏎ inserts what you wrote as typed. Without a command, ⏎ is a plain Return. See Commands.
From 0.7.0, @john opens the list of what can be done with "john" (Improve, say), and ⏎ would do the first row: press Esc or → to leave @john as typed, and go on typing. If you @-mention people often, change the magic key to another symbol, such as ~ (Settings → General → Magic key): @ then always types as text. Typed right after a letter or a digit (bob@example.com), @ is just text anyway. See Commands → The command list.
No. From 0.6.4, @ typed right after a letter, a digit, ., _ or - is just text: bob@example.com, ssh user@host and git@github.com:you/extensions.git type as usual, in every app, terminals included. See Commands → The command list.
Type it, then press Esc or ⇧⏎ (or → at the end): one @ puts in what you typed as it is, @agent included. Once the command is picked (Tab, or a space after its name), ⇧⏎ inserts the draft as typed too. (@claude isn't a built-in command from 0.6.4: from 0.7.0 one @ takes it as text like any other and offers what can be done with it, Improve, say, or opening the Claude app if you have it; Esc or ⇧⏎ puts it in as typed.)
Yes: Settings → Commands → "@agent hands it to": Claude Code (the default), Gemini CLI, Kiro CLI, or a command of your own, which gets what you typed as its last argument. It says whether the one picked is installed. Only Claude Code can work in the background (@tasks); the others open in Terminal. See Commands → @agent and @tasks.
Yes: Settings → Privacy → Apps without AI → "Add App…" (or the input menu's "This App: " → No AI). AI commands there send nothing and say so; typing and the other commands work. See Settings and Configuration → Per-app settings.
Yes, by itself: in an app, switch the input with Shift before you type anything in a field, to the same input in two fields in a row, and that app's fields start in it from then on; it says so once ("Slack starts in English from now on"). Your default input, the first, doesn't change. Forget it in the input menu's "This App: " or in Settings → Privacy → Learned…. See Settings and Configuration → The starting input, learned.
Turn on Settings → Privacy → "Hide sensitive information before sending": they're replaced with placeholders such as [EMAIL_1] on the Mac and put back in the results. It can't recognize names; add them under "Words to hide". See Privacy.
That's intentional: during secure input, keys go in as typed and nothing is sent to the AI. See Privacy.
Run the installer again ("Install AllInOneIME" from the disk image): it adds AllInOneIME back to your input sources. See Installation and Troubleshooting.
macOS doesn't show third-party input methods' options in System Settings. Open "AllInOneIME Settings" (Spotlight finds it), type @settings, or use the input method's icon in the menu bar → "Settings…".
No, the next request uses the new settings.
Yes, from 0.6.4: a role (role_arn with source_profile), SSO and credential_process profiles work as well as static keys. Credentials are fetched when a request needs them, kept in memory only and renewed before they expire, so there are no temporary keys to copy into ~/.aws/credentials. When an SSO sign-in ends, run the aws sso login --profile X command it gives. Profiles with mfa_serial aren't supported. See Settings and Configuration → AWS profiles.
The API key row in Settings → AI says so: "✓ Saved · ends in a1b2" (the key's last 4 characters), "✓ From $OPENAI_API_KEY" for a key in your shell (only with its own service's base URL or a server on this Mac: with another, such as DeepSeek or a relay, save a key for it), or "No API key yet". A key saved before 0.6.4 shows just "✓ Saved". Remove… asks before it removes a key. See Settings and Configuration → API keys.
Yes: put the bundle in a Git repository and add it under Settings → Commands → Extension Sources → "Add from Link…". It clones with your own git and SSH setup, shows what the bundle runs before anything loads, and checks once a day for new commits; nothing changes until you click Update. See Commands → Extension sources.
From 0.6.7 it shouldn't: on Amazon Bedrock, the Claude API and OpenAI-compatible services, a request that a model refuses for its temperature (a reasoning model, or a Claude model on Bedrock that won't take it with top_p) is sent again once without it, and the model is remembered, so its next requests leave it out. Settings → Privacy → Learned… lists the models remembered, and Forget sends it to one again. Otherwise, put "temperature": null in config.json.
Rewrites that only change punctuation or repeat another line aren't shown.
With maxTokens left at its default, the limit is raised automatically for long input; if you set it yourself, raise maxTokens in config.json, or click Restore Default by "Up to … output tokens" under Settings → AI → Model Settings.
When nothing is being typed, letters are inserted directly.
Yes. Terminals handle ⌘V themselves; to hand the clipboard's text to a command, press ⌃V ⏎ in the command (⌃V shows your clipboard history). Answers and snippets with several lines (or a tab) go in as a paste with Accessibility allowed and AllInOneIME set to Allow in System Settings → Privacy & Security → Paste from Other Apps, else on one line, so the shell doesn't run each line. With Terminal's "Secure Keyboard Entry" on, nothing is sent to the AI.
That's clipboard history (new in 0.6.8): ⌃V shows the text and images you copied lately. Press ⌃V twice: the second ⌃V pastes as the app does, and in a terminal that is ⌃V itself, so ⌃V ⌃V is vim's block selection, or the shell's "type the next key as is" (0.6.8.2: in a code editor too, VS Code, Cursor, JetBrains, Xcode; in other apps it's ⌘V). Or turn clipboard history off in Settings → General → Clipboard history: ⌃V then goes to the app as before 0.6.8 (in a command it appends the clipboard text). See Clipboard History.
macOS remembers the added input method, microphone access and preferences by bundle ID; changing it would mean adding and authorizing it again.
Yes: turn on "Type results out" in Settings → Advanced, then "Make occasional typos and fix them". Now and then a key next to the right one on your keyboard layout is hit and noticed up to three letters later, a letter or a space is typed twice, or a short word is typed, deleted and typed again; each is deleted and typed right. A few in 100 characters, never at the start of a line. In code, web and email addresses and numbers, a typo is fixed at once and is only ever a wrong letter or digit; Chinese, Japanese and Korean only hesitate; never in terminals.
In a field that takes typos back (Apple's text views such as TextEdit and Notes, browsers, most editors), typed to the end, or with another key to type the rest at once, the text is exactly the result; Esc (or leaving the field) in the middle of a typo takes the typo out first.
Typos are only made where the input method can take them back. Each time, the first typo is a plain one (a wrong letter corrected in one go) until the field has shown it takes a typo back. A field that ignores where to replace text keeps that first typo (the text ends up one character off), and its app is remembered and gets no typos again. Settings → Privacy → Learned… lists those apps ("Typos off in …"); Forget lets one try again. (Up to 0.6.6 they were kept in the input method's preferences; 0.6.7 moves them in.)
From 0.6.3 on: Settings → About → "Check for Updates", then "Update to "; it also looks once a day by itself and tells you (from 0.7.0 with a notification too), never installing until you click. Older versions: install the new disk image over it. See Installation and Troubleshooting → Updating.
Yes: click Don't Show Again on it, or turn off Settings → About → "Notify me when a new version is out" (0.7.0, on by default; it's there while "Check for updates automatically" is on). Either turns it off for every later version; turn the switch on again to have it back. The notification comes once per version, and its Update installs as About's button does; About still says when a new version is out. See Installation and Troubleshooting → Updating.
Requests to a base URL no longer follow a redirect, so that your key and your text never go on past the host the key is saved for. Put the address the base URL redirects to in Settings → AI → More… → Base URL. See Settings and Configuration → AI providers.
From 0.6.3 on, AllInOneIME is signed with a Developer ID, differently from earlier versions, so after updating from 0.6.2 or earlier (to 0.6.3 or later), macOS asks once for each key saved in the keychain ("AllInOneIME wants to use your confidential information…"). Enter your login password and click "Always Allow". It doesn't ask again, also after later updates. Keys you sync through iCloud Keychain ("API keys and passwords" under Sync through iCloud) aren't asked for after an update.
Type @reportissue and a short title, ⏎ to see what's added, ⏎ again to open the GitHub page, where you submit it; or use "Report an Issue…" in the input menu or Settings → About. See Commands → @reportissue.
Open "Install AllInOneIME" and click Uninstall…, then delete the data folders; see "Uninstall" in Installation and Troubleshooting.