Choosing an Agent
BojuBot can work with Claude or with Gemini. It runs each one through an agent CLI installed on your computer:
- Claude, through Claude Code, using your Claude Pro or Max subscription.
- Gemini, through Google's Antigravity CLI (
agy), which runs Gemini using your Google account's Antigravity quota. Antigravity also offers some Claude and GPT-OSS models on that quota. In BojuBot's settings and menus it's listed as Gemini (Antigravity CLI), and Claude Code as Claude (Claude Code).
Both work with the same chat panel, sessions, skills, UI Bridge and vault queries.
A common setup is to keep your Claude quota for heavy work, such as programming in Claude Code itself, and use Gemini for everyday note-taking in Obsidian. You can switch any time; each session remembers which agent it started on.
Setting up Antigravity (for Gemini)
- Install the Antigravity CLI. Follow the Antigravity CLI install guide.
- Sign in once. Open a terminal, run
agy, and sign in in the browser window that opens. You can close the terminal afterwards. BojuBot reuses that sign-in. - Pick it in BojuBot. If the Antigravity CLI is the only agent you installed, BojuBot uses it on its own. If you also have Claude Code, click the model name below the message box in the chat panel and pick a Gemini model under Gemini (Antigravity CLI). If BojuBot doesn't find
agyon its own, set Antigravity CLI binary path to the full path ofagy(on Windows usually%LOCALAPPDATA%\agy\bin\agy.exe).
You switch agents in the model picker: pick a model under the other agent. An empty new session that you haven't sent a message in yet switches straight away; a session with messages starts a new session on the other agent, because a conversation can't move between CLIs. The agent you picked last is the one new sessions start with.
To start a single session on the other agent without changing what new sessions use, Shift+click + and choose it in the Agent and model field of Custom Session.
What's different with Gemini
| Claude (Claude Code) | Gemini (Antigravity CLI) | |
|---|---|---|
| Models | Claude models, plus your custom-models.json | The models the Antigravity CLI offers: Gemini, plus some Claude and GPT-OSS models |
| Model picker default | Claude Sonnet | Lets the Antigravity CLI choose |
| Effort levels | When your Claude Code version supports them | Low to max |
| Chat only mode | Available | Available; switching into or out of it starts a new session |
| Standard mode | File edits allowed; read-only shell commands like ls allowed | File edits allowed; all shell commands denied |
| Read only mode | Reads files, no writes | Antigravity's plan mode: no writes |
| Context gauge and compact | Shown | Hidden: Antigravity doesn't report its context size or offer a compact command |
/usage | Your Claude plan usage | Remaining weekly and 5-hour quota for each Antigravity model group |
| Session history | Read from Claude Code's own history | BojuBot keeps a transcript next to the session file |
Cost per message. Antigravity adds roughly 12,000 tokens of its own instructions to every message and doesn't report cache reads. That counts against your Antigravity quota, not your Claude plan. Run /usage to see what's left.
Models from other providers. Antigravity's quota is split into groups (for example "Gemini Models" and "Claude and GPT models"), each with its own weekly and 5-hour limit. Using a Claude model through Antigravity draws on Antigravity's quota, not your Claude subscription.
Permissions on Antigravity
BojuBot runs Antigravity as one of its own Antigravity agents, which carry BojuBot's ground rules (plain [[wikilinks]], built-in file tools rather than shell commands, renames through BojuBot) and set which tools Antigravity may use. Permissions on each agent compares every mode on Claude Code and Antigravity, and explains why switching into or out of Chat only starts a new session.
| Mode | Antigravity agent | How it's enforced |
|---|---|---|
| Chat only | bojubot-chat | The agent only has web search and web pages. |
| Read only | bojubot | Antigravity's plan mode (agy --mode plan), which never writes to your vault. |
| Standard | bojubot | agy --mode accept-edits: notes can be created and edited, and every shell command is denied. When one is denied, the denial card offers full access for the session. |
| Full access | none when the session starts in Full access; bojubot when it's switched to Full access later | agy --dangerously-skip-permissions. |
Where the agents live. BojuBot writes bojubot.md and bojubot-chat.md to Antigravity's agents folder in your home folder, ~/.gemini/config/agents/, when it finds agy. It updates them when a new BojuBot version changes them, and never touches any other file there. They also appear in Antigravity's /agents list when you use agy on its own; you can ignore them there.
Older Antigravity versions. If your agy doesn't support agents (agy --help doesn't list --agent), or BojuBot can't write the files, sessions run without BojuBot's agents: Read only, Standard and Full access work as described above, without the ground rules, and Chat only isn't available.
Allowing particular shell commands. To allow commands such as git in Standard mode, add allow rules such as command(git) to Antigravity's own ~/.gemini/antigravity-cli/settings.json. See Antigravity permissions. These rules apply to all your agy use, not just BojuBot.
Troubleshooting
"Gemini (Antigravity CLI) not found" when the panel opens. You picked Gemini for new sessions, but BojuBot can't find the Antigravity CLI (agy). Install it and set Antigravity CLI binary path, then click Check again. Or, if Claude Code is installed, click Use Claude (Claude Code) instead in the panel.
"The Antigravity CLI isn't signed in" or "Your Antigravity CLI sign-in has expired." Click Open terminal in the error card, or run agy in a terminal yourself, and sign in. Then send your message again. See Signing in to Antigravity again.
"Model not available." The model saved for the session isn't offered by the Antigravity CLI any more. Pick another one from the model picker.
It asks for full access to create a note. Standard should allow file edits. If you still see this, check that you're in Standard mode, not Read only, and that you're on the latest BojuBot.
"Chat only needs a new Gemini session." The Antigravity CLI can't add or remove a conversation's tools once it has started, so moving into or out of Chat only starts a new session. Your previous session is in the Sessions panel. See Permissions on each agent.
"The Antigravity CLI couldn't start this mode's agent." Your Antigravity version doesn't accept one of BojuBot's agents, or an agent file was removed. Until agy is updated or reinstalled (or Obsidian restarts), new Antigravity sessions start without BojuBot's agents and Chat only isn't available; send your message again. Updating BojuBot and agy usually fixes it, and BojuBot tries its agents again on your next message after agy changes.
