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

main
md 64 lines 3.34 KB
Rendered Raw
1 # Secrets
2
3 T3 Code can read credentials from a secret provider, so the credential stays in your password
4 manager and T3 Code saves only a reference to it. Agents can also ask you for a secret in a
5 private card instead of in the chat.
6
7 The Secrets settings page is in preview and is not in every build yet. Secret requests from agents
8 work everywhere.
9
10 ## Secret providers
11
12 1Password is the supported provider. T3 Code reads secrets with the
13 [1Password CLI](https://developer.1password.com/docs/cli/) (`op`), so `op` must be installed and
14 signed in on the machine that runs the T3 Code server. When you use T3 Code on another machine or
15 from your phone, that is the remote machine, not the device in front of you.
16
17 A desktop sign-in asks for approval on that machine, which a remote user cannot answer. On a remote
18 or headless server, sign `op` in with a [service account](./secrets-1password-service-account.md) or a
19 [Connect server](./secrets-1password-connect.md) instead.
20
21 To add one, open **Settings → Secrets**, select **Add provider**, and enter a name and the
22 1Password account: the shorthand, sign-in address (without `https://`), or ID that
23 `op account list` shows. Secret providers belong to the environment you are connected to. Each
24 environment keeps its own list.
25
26 ## Use a secret reference
27
28 Credential fields in Settings, such as provider environment variables and credentials, source
29 control tokens, usage limit keys, and device host tokens, show a source picker next to the field.
30 Pick **Value** to save the credential itself, or pick a secret provider and enter a reference such
31 as `op://vault/item/field`. Copy the reference from 1Password with **Copy Secret Reference**.
32 Select the check button next to a reference to read it now. If it reads, providers that use it
33 start using the new value.
34
35 T3 Code reads the secret when it needs it, for example when a provider starts. Change the
36 credential in 1Password and refresh to use the new value.
37
38 ## When a secret cannot be read
39
40 If 1Password is locked or signed out, the provider or feature that needs the secret shows an error
41 naming the secret provider. Unlock 1Password on the server's machine, then select **Refresh** in
42 **Settings → Providers**. T3 Code never replaces a saved credential it cannot read with another
43 login.
44
45 ## Remove a secret provider
46
47 When you remove a secret provider in **Settings → Secrets**, T3 Code lists the fields that read
48 from it. Removing it clears those fields, so set them again before you need them. The secrets in
49 1Password are not touched.
50
51 ## When an agent asks for a secret
52
53 An agent that needs a token or password shows a secret request card in the thread instead of asking
54 you to paste it into the chat. Type or paste the value and select **Save securely**, or select
55 **Decline**. You can answer from web, desktop, or mobile.
56
57 If the environment has a secret provider, the card also lets you pick it and enter a reference
58 instead of the value. T3 Code reads the secret once, when you answer. If 1Password is locked, the
59 card says so and the request stays open: unlock it and try again, or enter the value.
60
61 The value never appears in the conversation. Most requests keep it from the agent too: T3 Code
62 passes it to the tool that needs it. When an agent has to run a command with the value, the card
63 says so instead: the value goes into a private file that the agent's commands can read for about 24
64 hours.