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

main
md 117 lines 6.58 KB
Rendered Raw
1 # Welcome page
2
3 T3 Code shows a Welcome page when you open a new installation. Existing
4 workspaces skip it. It shows what T3 Code found on the computer you are using,
5 on one page: your agents, projects from your Claude Code, Codex, and Pi history,
6 and the phone app. Only an agent is needed to start chatting.
7
8 To see the page again, go to **Settings → About → Welcome page** and select
9 **Open**. Direct links, such as Settings, open normally before setup is done.
10
11 The hosted app at app.t3.codes does not open the page. With no computer connected,
12 it asks you to sign in to T3 Connect, then to install T3 Code and run
13 `t3 connect` on your computer. From home, it adds compatible computers linked to your account and
14 opens the app. To add more computers later, use **Settings → Environments**.
15
16 If T3 Code cannot confirm the workspace during startup, it shows
17 **Still connecting** instead of opening the app. Select **Reload** to try again.
18
19 If T3 Code cannot read your saved settings, it shows **Could not read settings**.
20 Select **Retry** after storage becomes available. Setup does not replace
21 unreadable settings with defaults.
22
23 ## Agents
24
25 T3 Code lists the agents it found on the computer first, ready ones on top.
26 **Add more agents** lists every other agent T3 Code supports, A to Z. When no agent
27 is found, it reads **Set up an agent** and opens by itself:
28
29 - **Turn on** enables an agent that is off on this computer, including one only
30 some projects use. T3 Code then checks whether it is installed and signed in.
31 - For Claude Code, **Install** or **Sign in** opens a terminal with the correct
32 command ready to run. Install uses the vendor's own installer, which keeps
33 **Update now** working in Settings.
34 - For Codex, **Set up** offers sign-in with your ChatGPT account or your own
35 Codex CLI. **Use existing CLI** opens the terminal to install or sign in, and
36 **Continue with ChatGPT** stays available until Codex is signed in.
37 - When T3 Code knows an installed version does not work with it, **Update** opens
38 the agent in **Settings → Providers**, which shows the version to use and updates it
39 when it can.
40 - Other agents, and agents that could not load, open their page in
41 **Settings → Providers**.
42 - **Browse** opens the ACP Registry for more agents.
43
44 On the desktop app, when the folder of the `t3` command is not on your `PATH`,
45 **Add to PATH** adds one line to your shell's startup file.
46
47 The setup terminal uses the home directory and environment configured for the
48 provider instance. Sensitive values remain redacted in Settings and
49 terminal metadata while the terminal process can use them.
50
51 **Start** waits for one ready agent. Select **Start without an agent** to finish
52 without one. Checked projects are still imported.
53
54 ## Phone
55
56 Select **Set up** and scan the code with your phone. It opens the App Store on an
57 iPhone and Google Play on Android. Then select **Sign in to T3 Connect** and allow
58 this computer when T3 Code asks, so the app can reach it. Sign in to the app with
59 the same account. If you are signed in but this computer is not shared yet, select
60 **Set up T3 Connect**. If T3 Connect is on but the app cannot reach this computer,
61 select **Check T3 Connect** to see why. The page leaves the phone out on builds
62 without T3 Connect, or when your organization turns it off. You can still pair the
63 app with a code from **Settings → Sharing & access**.
64
65 ## Projects
66
67 T3 Code finds directories that Claude Code, Codex or Pi has used. Git repositories
68 are listed first, newest activity on top. When the remote is on GitHub, the
69 group shows the repository as `owner/name`. Clones with the same remote share
70 one group. Directories that are not git repositories sit under "Other folders".
71
72 The page offers git repositories active within the last 30 days with at least
73 three conversations, already checked. Projects already in T3 Code are not checked
74 again. Uncheck the box to start without them, or
75 select **Review all** to pick from everything found, with "Select all" and
76 "Select none". Linked worktrees of bare repositories
77 can be offered as separate projects. Conversations in other linked git worktrees
78 count toward their main checkout, so a repository is offered even if you only
79 worked in its worktrees. Codex scratch directories under `Documents/Codex`, and
80 anything under `Downloads` are not offered.
81
82 A large or malformed history can reach the scan limit. T3 Code keeps the
83 projects it found and warns when projects or conversations may be missing.
84
85 Imported projects include Claude, Codex and Pi conversations active within the last
86 30 days. You can continue those conversations in T3 Code. Pi is off by default:
87 open **Add more agents** and select **Turn on** next to Pi, and the page looks for
88 its sessions too. Pi sessions
89 are read from each enabled Pi provider's session directory, which follows
90 `PI_CODING_AGENT_SESSION_DIR` and `PI_CODING_AGENT_DIR` in its environment. A
91 Pi conversation imports its active branch, the one Pi reopens.
92
93 Conversation import is best effort. T3 Code keeps the first user prompt and the
94 newest remaining visible user and assistant messages, with 200 messages total.
95 It omits tool activity and attachments. For Codex, it omits generated setup
96 context only when a canonical user event and a valid shared turn ID identify the
97 same user turn. Ambiguous legacy or response-only context stays in the imported
98 conversation so T3 Code does not remove user text. For Claude, slash commands
99 and `!` shell commands appear as you typed them; their output, background task
100 notifications and interruption markers are left out, and a conversation that
101 only ran commands such as `/clear`, with no reply, is skipped. It reads one
102 conversation at a time and skips files larger than 4 GiB. It also skips a conversation when the
103 message text and metadata it keeps need more than 32 MiB of memory. Tool output
104 does not count toward that limit. It skips a conversation with more than 100,000
105 records every time, so opening the page again does not import it. It ignores
106 malformed records and conversations with no messages, such as a session opened
107 in an editor but never used. It skips unreadable or unparseable conversations.
108
109 Each import attempt reads up to 100 conversations and 4 GiB per project.
110 Conversations with no messages count toward the 4 GiB but not the 100. To
111 continue a large batch, open the Welcome page again and pick the project in
112 **Review all**. Completed conversations are not imported again. You can continue
113 without the remaining history.
114
115 You can start without importing. While an import runs, T3 Code stays on the
116 Welcome page. If you quit, open the Welcome page again from **Settings → About**; the
117 projects you started stay checked.