The best way to control Claude Code, Codex and more from any computer or phone

main
md 172 lines 8.85 KB
Rendered Raw
1 # Antigravity
2
3 T3 Code runs Google's official Antigravity ACP agent on your selected environment.
4 T3 manages its own CLI installation and sign-in, separate from your terminal or IDE. Google controls
5 which models and account access are available through this agent.
6
7 ## Set up Antigravity
8
9 On web or desktop, open **Settings > Providers**, choose the environment that runs
10 your project, and enable Antigravity. Install its runtime there, then choose
11 **Sign in** and complete the browser sign-in. Wait for T3 Code to confirm
12 account access and load models before starting a thread. Once the runtime is installed,
13 you can also sign in from **Settings > Providers** in the mobile app.
14
15 Installation continues if you leave settings or reconnect. Setup requires
16 permission to operate the environment; update an older server if it does not offer
17 Antigravity setup.
18
19 ### Sign in from a remote device
20
21 Google finishes on an Antigravity page that shows a code. Paste that code, or the
22 page's full address, into the code field in the client where you started sign-in.
23 This works the same from any device.
24
25 The code is temporary. Paste it only into the setup field. The page alone does not
26 confirm account access; wait for T3 Code's confirmation.
27
28 ### Other sign-in methods
29
30 Choose **Sign-in method** in the Antigravity provider settings:
31
32 | Method | Credentials |
33 | -------------------------- | -------------------------------------------------------------------------------------------- |
34 | Google account | Personal Google sign-in in the browser |
35 | Gemini Enterprise | Browser sign-in, GCP project, and GCP location |
36 | Gemini API key | API key; choose Connect without a browser |
37 | Agent Platform / Vertex AI | API key, or GCP project and location with Application Default Credentials on the environment |
38
39 The environment stores the Antigravity API key outside its settings file, and
40 clients only see whether one is saved. The agent uses the method and credentials selected for this instance;
41 ambient `GEMINI_API_KEY` and Google credential variables do not override them.
42 Changing the method stops the instance's sessions. Sign out before replacing an
43 account.
44
45 ## Runtime installation
46
47 Managed installation supports Apple Silicon and Intel macOS, Linux x64 or ARM64
48 with glibc or musl, and Windows x64 or ARM64. Allow at least 1.25 GiB of free disk
49 space for downloading and staging an update.
50
51 ### Use a manual installation
52
53 Install [Antigravity CLI](https://antigravity.google/docs/getting-started) on the environment.
54 Set **Binary path** to its `agy` executable and update it yourself.
55 Leave the field blank to use the managed runtime, or a compatible executable on
56 `PATH` if no managed runtime is installed.
57
58 ## Update the managed runtime
59
60 In web or desktop provider settings, choose **Update Antigravity** when an update
61 is available. T3 checks Google's CLI release channel while provider update checks
62 are enabled. Installing or reinstalling also checks that channel. Updates keep
63 your profile and existing runtime available if the new release fails validation.
64
65 T3 needs Antigravity 1.5 or newer and recommends 1.5.12 or newer. Sessions do not
66 start on an older runtime: update the managed runtime here, or update the executable
67 a custom binary path or `PATH` points at. You may need to sign in again after
68 updating from a runtime older than 1.5. Threads already running finish with their
69 original runtime; new sessions use the updated release. Custom binary paths keep
70 using the executable you selected.
71
72 ## Models and threads
73
74 The model list comes from your Antigravity account, including Claude and GPT models
75 when your plan has them. Pick a thinking level beside the model list in the model picker; it
76 shows only the levels the selected model supports. A resumed thread keeps its
77 selected model. If access to that model ends, select another available model
78 before continuing.
79
80 Antigravity creates empty `.gemini/skills` and `.agents/skills` folders in the
81 workspace when a session starts. Git does not track empty folders, so they never
82 appear in commits.
83
84 Use Antigravity's native `/plan` command for planning. Tool approvals follow [Permission modes](./permission-modes.md).
85 Questions with fixed choices still need one of the offered answers, even in
86 **Full access**.
87
88 On web and desktop, [Edit from here](./composer.md#edit-an-earlier-prompt) works with
89 Antigravity. Antigravity cannot rewind its own conversation, so the next turn
90 starts a fresh Antigravity session and T3 Code sends it the kept conversation,
91 without the turns you removed.
92
93 Use `/compact` to summarize a long conversation when your Antigravity runtime
94 offers that command. If it is unavailable, update Antigravity in provider settings
95 or send `/clear` when you need a fresh context.
96
97 ### Skills and attachments
98
99 Put project skills in `.agents/skills`. T3 Code also reads `.gemini/skills` and the
100 legacy `.agent/skills` directory. Among these project locations, the first copy
101 wins in this order: `.gemini/skills`, `.agents/skills`, `.agent/skills`. See
102 [commands and skills](./composer.md#commands-and-skills) for invoking them.
103
104 Skills for every project go in `~/.gemini/config/skills` or
105 `~/.gemini/antigravity-cli/skills`. Antigravity does not read `~/.agents/skills`
106 on its own; to share a folder like that one, list it in `~/.gemini/config/skills.json`
107 (or a project's `.agents/skills.json`), and T3 Code shows the skills it declares,
108 honoring `inherits`, `include_only`, and `exclude`.
109
110 Antigravity receives images and audio directly, and reads PDFs and text files as
111 documents. Other attachments, including videos, are passed as a saved file path for
112 the agent to inspect with its tools.
113
114 ### Subagents
115
116 Antigravity groups subagent activity into batches. Open a batch and select
117 **Subagent work** (**Work** on mobile) to read each child's role, prompt, and recent steps. This view
118 is read only: you cannot message or control individual subagents, and an idle
119 batch does not confirm that every child succeeded. If Antigravity did not record
120 which children a batch started, the view says so. See
121 [agent work](./thread-sidebar.md#inspect-agent-work) for where to inspect
122 activity.
123
124 ## Accounts and removal
125
126 Add an Antigravity provider instance for each Google account in
127 **Settings > Providers** on web or desktop. Each has its own sign-in; downloaded
128 runtimes are shared on the environment.
129
130 | Action | Effect |
131 | ------------------------- | ----------------------------------------------------------------- |
132 | Disable | Stops the instance's sessions and keeps its Google sign-in. |
133 | Sign out | Stops the instance's sessions and removes its saved Google login. |
134 | Remove downloaded runtime | Removes the shared installation and keeps Google credentials. |
135
136 All three keep thread history and workspace files. Sending `/logout` by itself in
137 a thread signs out its instance, including stopping that instance's other sessions.
138 That needs a client allowed to manage providers, and it has to be your own message:
139 `/logout` from an agent or a scheduled task is refused.
140 Sign out, then sign in again to replace an account.
141
142 Before removing a managed runtime, disable its instances and cancel any active
143 installation. Clear any explicit binary path pointing into that runtime. Removal
144 is refused while the runtime is in use.
145
146 ## Run a native goal
147
148 When your Antigravity runtime offers `/goal`, send `/goal` followed by a verifiable
149 objective. Antigravity keeps working until it completes the goal or you cancel it.
150
151 Use Stop to interrupt a running goal, then ask Antigravity to stop pursuing it
152 before starting more work. Ordinary follow-ups wait until the running turn ends.
153 T3 does not support Antigravity goal status, pause, resume, or clear commands.
154
155 ## Check access and troubleshoot
156
157 Open **Usage > Limits** to see the remaining Gemini and shared Claude/GPT allowances
158 for Google sign-ins. Each group has separate five-hour and weekly limits and reset
159 times. Limits refresh with provider status and include usage outside T3 Code.
160
161 A server restart keeps your Google sign-in. The provider shows the saved account
162 until a session, a refresh, or a sign-out reports something new.
163
164 To check access and reload models, use **Refresh provider status** in web or desktop
165 provider settings, or **Refresh models** in mobile thread settings. If asked to
166 sign in again, use provider settings on web or desktop, or **Settings > Providers** on mobile.
167
168 If Google reports `SUBSCRIPTION_REQUIRED`, an account restriction, or a usage limit,
169 follow the provider's message and any retry time. See [Google's account plans][plans]
170 for eligibility.
171
172 [plans]: https://antigravity.google/docs/plans