README file from
GithubAntigravity CLI Sidebar
An Obsidian plugin that embeds Antigravity CLI directly into a sidebar pane, so you can chat with Antigravity without leaving your notes.
[!NOTE] Version 2.0 Update: This version (V2.0) has transitioned to support the new Antigravity CLI (
agy). The older V1.0 version was designed for the original Gemini CLI (gemini). Since Google is deprecating/shutting down Gemini CLI, V2.0 has been fully migrated to support Antigravity CLI and handles automatic migration of your settings.
Features
- 🚀 Run Antigravity CLI inside Obsidian's sidebar
- ⌨️ Full terminal interaction (typing, scrolling, resizing)
- 🎨 Clean xterm.js-based terminal UI
- ⚙️ Customizable command and arguments
- 💻 Desktop-only (uses Node.js child_process)
Requirements
Before installing, make sure you have:
- Obsidian Desktop (Windows / macOS / Linux)
- Antigravity CLI installed and available in your system
PATHasagy- Install from: https://antigravity.google
- Python 3 installed (used for the PTY wrapper)
- Linux/macOS:
python3 - Windows:
python
- Linux/macOS:
Installation
Manual Install
- Download the latest release (
main.js,manifest.json,styles.css). - Create a folder inside your Vault:
<vault>/.obsidian/plugins/antigravity-cli-sidebar/ - Copy the three files into that folder.
- Restart Obsidian.
- Go to Settings → Community Plugins, find Antigravity CLI Sidebar, and enable it.
From Source
git clone https://github.com/desmondwen/obsidian-antigravity-cli-sidebar.git
cd obsidian-antigravity-cli-sidebar
npm install
npm run build
Then copy main.js, manifest.json, and styles.css to your Vault's plugins folder as described above.
Usage
Open the Terminal
Once enabled, you can open the Antigravity CLI sidebar in two ways:
- Ribbon Icon: Click the 🤖 bot icon in Obsidian's left sidebar.
- Command Palette: Press
Ctrl+P(orCmd+P) and type "Open Antigravity CLI".
The terminal will appear in the right sidebar, automatically launching:
agy --dangerously-skip-permissions --continue
Customize Settings
Go to Settings → Antigravity CLI Settings to change:
| Setting | Description | Default |
|---|---|---|
| Antigravity Command | Path to the Antigravity CLI executable | agy |
| Default Arguments | Arguments passed on every launch | --dangerously-skip-permissions --continue |
How It Works
The plugin uses:
- xterm.js for the terminal UI inside Obsidian
- A Python PTY wrapper (
terminal_pty.py/terminal_win.py) to spawn an interactive TTY - Node.js
child_processto bridge the Python wrapper with xterm.js
The terminal uses your Vault root as the working directory (cwd).
Uninstall
- Disable the plugin in Settings → Community Plugins.
- (Optional) Delete the plugin folder:
<vault>/.obsidian/plugins/antigravity-cli-sidebar/
Troubleshooting
| Problem | Solution |
|---|---|
| Terminal is blank | Make sure agy is installed and in your PATH. Test by running agy in a normal terminal. |
| "python3" not found | On some systems, only python exists. Create a symlink: ln -s $(which python) /usr/local/bin/python3 |
| Plugin won't enable | Ensure you are on Obsidian Desktop; this plugin does not support mobile. |
Author
desmond wen
License
ISC