Book analysis won’t start
RooBook uses the AI you chose under AI for Book Analysis in Settings (⌘ ,) to work out chapters, sections, and figures. Check the one you chose.
OpenAI (Codex)
- Codex isn’t bundled with the app. Install it with
brew install codexor the ChatGPT app. - In RooBook’s Settings, choose Sign In with OpenAI and finish signing in in your browser.
- Run
roobook doctorin Terminal to see which Codex RooBook uses, its version, and why it can’t be found if it’s missing.
The list of models comes from what your signed-in account can use.
Claude
- Save an API key from Anthropic Console in RooBook’s Settings. Usage is billed to the key’s organization.
- If the model list doesn’t load, check your API key and your connection.
Ollama
- Make sure Ollama is running on this Mac.
- If it has no models, run a command such as
ollama pull qwen3-vlin Terminal, then choose the model in RooBook’s Settings. - With a model that can’t read images, body text isn’t assembled from the page and figures aren’t described. Contents, chapters, sections, and bibliographic details are analyzed from the OCR text only, and the book is marked for review.
Change the app’s language
- On a Mac, choose it under App Language in Settings and restart RooBook. Match System follows the order in macOS Language & Region settings.
- On iPhone and iPad, choose it in the Settings app under RooBook → Language. If Language isn’t shown, add both English and Japanese to Preferred Languages in General → Language & Region.
- In Slack, switch the language of
/roobookreplies with/roobook language enor/roobook language ja.
A PDF import is stuck or failed
- Imports run in the processing queue. They keep going after you close the window and slow down when your Mac is under heavy load.
- Temporary failures, such as a busy model, are retried automatically after a pause.
- Retry a failed item from the processing queue.
- If some steps didn’t finish, the processing results sheet opens. Choose to process the book again, finish without the items that can wait, or delete the book.
- In Terminal,
roobook queueshows the status androobook queue --retry <job-id>tries a job again.
When you’re offline
Signing in, adding and analyzing PDFs, syncing your library, and using AI connectors need an internet connection.
The roobook command reads the books cached on your Mac. roobook library --local-only lists only the books on this Mac.
Your AI connector won’t connect
- The connector URL is
https://api.roobook.app/mcp. Add it as a custom connector in an AI app that supports remote MCP servers. - In Claude, you can also add RooBook from the Claude Directory.
- When asked, sign in with your RooBook account (the email and password you registered in the app) and allow access.
- The AI can reach only the library of the account you connected. If it can’t find a book, check that the book shows as processed in the app.
- To disconnect, remove the connector in your AI app.
Unlink Slack
Run /roobook unlink in Slack to unlink your RooBook account. Removing the RooBook app from your Slack workspace also unlinks it.
Delete your account
In the app, open the Account menu and choose Delete Account. This permanently deletes your account details, books, PDFs, OCR data, notes, and reading progress.
Anything else
The guide covers everything from installing RooBook to connecting your AI. RooBook doesn’t offer a support contact at the moment.