Skip to content

Commit 3063192

Browse files
bavekubaveku
committed
feat(antigravity): add Antigravity extension host and Auxiliary Pane sidecar
1 parent a65e05e commit 3063192

26 files changed

Lines changed: 782 additions & 15 deletions

‎apps/antigravity/.antigravity-plugin/plugin.json‎

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
{
2+
"name": "mobile-dev",
3+
"displayName": "Mobile Dev",
4+
"description": "Stream iOS and Android devices beside your chat while building, running, or debugging mobile apps. Includes device control (agent-device), native and Metro logs, app storage inspection, and CPU, memory, and FPS performance profiling.",
5+
"logo": "assets/icon.png",
6+
"suggestedPrompts": [
7+
"Open the iOS simulator or Android emulator beside this chat",
8+
"Read the mobile app logs and help me fix the current error",
9+
"Record CPU, memory, and FPS while I interact with the app"
10+
],
11+
"author": {
12+
"name": "Callstack",
13+
"email": "hello@callstack.com",
14+
"url": "https://www.callstack.com/"
15+
},
16+
"homepage": "https://github.com/callstackincubator/codex-mobile-dev-plugin",
17+
"repository": "https://github.com/callstackincubator/codex-mobile-dev-plugin",
18+
"license": "MIT",
19+
"keywords": [
20+
"mobile",
21+
"ios",
22+
"android",
23+
"react-native",
24+
"expo",
25+
"simulator",
26+
"emulator",
27+
"profiling",
28+
"performance",
29+
"logs"
30+
]
31+
}

‎apps/antigravity/README.md‎

Lines changed: 60 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,60 @@
1+
# Mobile Dev for Antigravity
2+
3+
Build, run, and debug iOS and Android apps without leaving Antigravity. Mobile Dev
4+
streams your simulators, emulators, and devices into an Antigravity Auxiliary Pane
5+
(`mobile-dev.device-panel`) beside the chat, and gives Antigravity the tools to
6+
control them, read their logs, inspect your app, and measure its performance. It
7+
works with Expo, React Native, SwiftUI, and other native mobile projects.
8+
9+
- **Auxiliary Pane device panel:** a live, interactive iOS simulator, Android
10+
emulator, or connected device in the Antigravity side pane, with logs and
11+
performance tools beside it. Antigravity reads the devices you select there and the
12+
logs, screenshots, and notes you add to chat.
13+
- **Device control and inspection:** Antigravity taps, types, scrolls, reads the
14+
accessibility tree, and takes screenshots through the bundled
15+
[agent-device](https://agent-device.dev/) runtime.
16+
- **App control:** install, launch, and stop apps, open deep links, send test pushes,
17+
and set permissions and languages.
18+
- **App Flow:** a visual map of your app's screens and the navigation between them,
19+
read from your Expo Router or React Navigation source and optionally captured by
20+
walking the app on an iOS simulator.
21+
- **Logs:** iOS unified logs, Android logcat, physical iPhone logs, and Metro console
22+
messages.
23+
- **Performance:** CPU, memory, and FPS recordings shown as interactive charts in
24+
chat, which Antigravity can analyze and compare.
25+
- **App storage:** read what your app saved, such as UserDefaults, SharedPreferences,
26+
AsyncStorage, MMKV, and SQLite, without adding code to it.
27+
- **Profile analysis:** TraceSift findings for local CPU and React profiles.
28+
29+
## Install
30+
31+
Install directly from the `release/antigravity` branch with the `agy` CLI:
32+
33+
```sh
34+
agy plugin install https://github.com/callstackincubator/codex-mobile-dev-plugin/tree/release/antigravity/mobile-dev
35+
```
36+
37+
Or package and install from a local checkout:
38+
39+
```sh
40+
npm run build
41+
npm run package:antigravity
42+
agy plugin install ./release/antigravity-plugin/mobile-dev
43+
```
44+
45+
Open the **Mobile Dev** icon in the Antigravity activity bar (Auxiliary Pane) or ask
46+
Antigravity to open your app on a simulator.
47+
48+
## Requirements
49+
50+
- An Apple Silicon Mac.
51+
- **Node.js 22.19 or later.** Mobile Dev looks for it on `PATH` and in the usual
52+
Homebrew, nvm, fnm, Nix, Volta, mise, and asdf locations.
53+
- **iOS:** Xcode 26 or later with an installed simulator runtime. Physical iPhone
54+
logs need Xcode 27 or later.
55+
- **Android:** Android SDK platform-tools and emulator, and an AVD or a device with
56+
USB or wireless debugging authorized.
57+
58+
## License
59+
60+
MIT. See [LICENSE](LICENSE) and [third-party notices](THIRD_PARTY_NOTICES.md).

‎apps/antigravity/assets/icon.png‎

211 KB
Loading

‎apps/antigravity/hooks.json‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
{
2+
"mobile-dev-node-check": {
3+
"SessionStart": [
4+
{
5+
"type": "command",
6+
"command": "/bin/sh ./scripts/launch-node.sh --check",
7+
"timeout": 10
8+
}
9+
]
10+
}
11+
}

‎apps/antigravity/mcp_config.json‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
{
2+
"mcpServers": {
3+
"mobile-dev": {
4+
"command": "/bin/sh",
5+
"args": [
6+
"${PLUGIN_ROOT}/scripts/launch-node.sh",
7+
"${PLUGIN_ROOT}/dist/server.mjs"
8+
]
9+
}
10+
}
11+
}

‎apps/antigravity/package.json‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
{
2+
"name": "@mobile-dev/antigravity",
3+
"version": "0.0.0",
4+
"private": true,
5+
"type": "module",
6+
"description": "Antigravity: the Antigravity extension manifest and Auxiliary Pane sidecar for the shared server and MCP Apps panel."
7+
}

‎apps/antigravity/plugin-host.json‎

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
{
2+
"label": "Antigravity",
3+
"manifest": ".antigravity-plugin",
4+
"mcpConfig": "mcp_config.json",
5+
"hooks": "hooks.json",
6+
"root": "PLUGIN_ROOT",
7+
"config": {
8+
"file": "antigravity-mcp-config.json",
9+
"target": "~/.gemini/antigravity/mcp_config.json"
10+
},
11+
"panelRuntime": "download",
12+
"build": "tooling/build.mjs",
13+
"skills": [
14+
"skills/mobile-dev",
15+
"../../packages/skills/agent-device"
16+
],
17+
"folders": [
18+
"scripts",
19+
"sidecars",
20+
"mcp_config.json",
21+
"hooks.json"
22+
],
23+
"readme": "README.md",
24+
"maxFileBytes": 5242880
25+
}

‎apps/antigravity/scripts/launch-node.sh‎

Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
#!/bin/sh
2+
# Runs Mobile Dev with Node.js 22.19 or later.
3+
# launch-node.sh <script> [args] runs the script with the first usable Node.
4+
# launch-node.sh --check prints a SessionStart hook result when none is found.
5+
# Claude starts plugin servers and hooks with the PATH it was launched with. Opened
6+
# from the Dock, that PATH usually lacks version managers, so also try their usual
7+
# install locations.
8+
set -u
9+
10+
message="Mobile Dev needs Node.js 22.19 or later, and none was found on PATH or in Homebrew, nvm, fnm, Nix, Volta, mise or asdf locations. Install it, for example with 'brew install node' or from https://nodejs.org, then restart Claude."
11+
12+
usable() {
13+
[ -x "$1" ] && "$1" -e 'const [major, minor] = process.versions.node.split(".").map(Number); process.exit(major > 22 || (major === 22 && minor >= 19) ? 0 : 1)' >/dev/null 2>&1
14+
}
15+
16+
candidates() {
17+
command -v node
18+
for directory in /opt/homebrew/bin /opt/homebrew/opt/node/bin /opt/homebrew/opt/node@24/bin /opt/homebrew/opt/node@22/bin /usr/local/bin \
19+
"$HOME/.volta/bin" "$HOME/.local/share/mise/shims" "$HOME/.asdf/shims" \
20+
"$HOME/.local/share/fnm/aliases/default/bin" "$HOME/Library/Application Support/fnm/aliases/default/bin" \
21+
"$HOME/.nix-profile/bin" "/etc/profiles/per-user/${USER:-$(id -un)}/bin" /run/current-system/sw/bin /nix/var/nix/profiles/default/bin; do
22+
echo "$directory/node"
23+
done
24+
for path in "$HOME"/.nvm/versions/node/*/bin/node "$HOME"/.local/share/mise/installs/node/*/bin/node \
25+
"$HOME"/.local/share/fnm/node-versions/*/installation/bin/node "$HOME"/Library/Application\ Support/fnm/node-versions/*/installation/bin/node; do
26+
echo "$path"
27+
done
28+
}
29+
30+
node=$(candidates 2>/dev/null | while IFS= read -r candidate; do
31+
if [ -n "$candidate" ] && usable "$candidate"; then echo "$candidate"; break; fi
32+
done)
33+
34+
if [ "${1:-}" = "--check" ]; then
35+
[ -n "$node" ] && exit 0
36+
printf '{"systemMessage":"%s","hookSpecificOutput":{"hookEventName":"SessionStart","additionalContext":"Mobile Dev tools are unavailable: Node.js 22.19 or later was not found. When the user asks for iOS or Android device work, explain this and offer to install Node.js (with Homebrew when brew is available, otherwise from https://nodejs.org), then ask them to fully restart Claude."}}\n' "$message"
37+
exit 0
38+
fi
39+
40+
if [ -z "$node" ]; then
41+
echo "$message" >&2
42+
exit 1
43+
fi
44+
exec "$node" "$@"

‎apps/antigravity/server/index.ts‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
import "@mobile-dev/core/instrument.ts";
2+
3+
// The server loads once telemetry runs, as a module of its own: the build splits the
4+
// bundle there, keeping each file under the Antigravity plugin directory's 5 MiB limit.
5+
await import("./server.ts");

‎apps/antigravity/server/server.ts‎

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,34 @@
1+
import { mkdir, readFile, writeFile } from "node:fs/promises";
2+
import { homedir } from "node:os";
3+
import { dirname, join } from "node:path";
4+
import { runStdioServer } from "@mobile-dev/core/stdio-server.ts";
5+
import { agentDeviceTools, readAgentDeviceCatalog } from "@mobile-dev/core/agent-device-tools.ts";
6+
import { createPanel } from "@mobile-dev/core/panel-tools.ts";
7+
import { browserPanel } from "@mobile-dev/core/browser-panel.ts";
8+
import { downloadedPanelRuntime, panelRuntimeReleaseSchema, usePanelRuntime } from "@mobile-dev/core/panel-runtime.ts";
9+
10+
const stateFile = process.env.MOBILE_DEV_SIDECAR_STANDALONE === "1"
11+
? "antigravity-standalone.json"
12+
: "antigravity-panel.json";
13+
const statePath = join(homedir(), "Library", "Caches", "mobile-dev", stateFile);
14+
15+
async function writePanelState(url: string) {
16+
try {
17+
await mkdir(dirname(statePath), { recursive: true });
18+
await writeFile(statePath, JSON.stringify({ pid: process.pid, url, updatedAt: Date.now() }) + "\n");
19+
} catch {}
20+
}
21+
22+
const pinned = await readFile(new URL("./panel-runtime.json", import.meta.url), "utf8").catch(() => undefined);
23+
if (pinned !== undefined) usePanelRuntime(downloadedPanelRuntime(panelRuntimeReleaseSchema.parse(JSON.parse(pinned))));
24+
await runStdioServer({
25+
panel: createPanel({ inline: false }),
26+
features: [
27+
agentDeviceTools(readAgentDeviceCatalog()),
28+
browserPanel({
29+
always: true,
30+
onPage: writePanelState,
31+
instructions: url => `Mobile Dev's panel is a page to show beside the chat, not in it. In Antigravity, the Mobile Dev Auxiliary Pane (sidecar "mobile-dev.device-panel") renders ${url} automatically; you can also surface a toggle pill for "mobile-dev.device-panel" or open ${url} if needed. The page shares the user's devices and what they add to chat through mobile_read_panel_context; read it before device work.`,
32+
}),
33+
],
34+
});

0 commit comments

Comments
 (0)