The best way to control Claude Code, Codex and more from any computer or phone
Mirrored from https://github.com/Camo67/t3code.git
Synced Nov 21, 03:37 UTC
| 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 |