Skip to content

Latest commit

 

History

History
77 lines (57 loc) · 4.71 KB

File metadata and controls

77 lines (57 loc) · 4.71 KB

Organizing threads

Pin a thread from its context menu to keep it in the pinned section above your active work. mod+shift+p pins or unpins the thread you have open. Pinned threads are shown independently of their project, including when you connect to more than one environment.

To require confirmation before unpinning, enable Settings → General → Unpin confirmation. The confirmation applies to the sidebar controls, thread menus, and the mod+shift+p shortcut.

Pinned threads still move to Settled when they become inactive. They also move when their pull request merges if Auto-settle merged threads is enabled.

Each server stores its own copy of the automatic settlement settings and checks them even when no web, desktop, or mobile client is connected. By default, it settles threads after three days without activity and when their pull request merges. An eligible idle thread also settles when its pull request closes. An open pull request blocks inactivity settlement. Active work, pending input, and live background work keep the thread active. T3 Code settles from a closed or merged pull request only when its timestamp is not older than the user's latest activity. If that timestamp is not available, the inactivity rule still applies. A manual un-settle also keeps the thread active.

Settled lists threads by when their work finished, newest first. A thread you settle yourself sorts by the moment you settled it. A thread that settled on its own sorts by its last message or turn, not by when the server noticed it was inactive.

Change these rules in Settings > General. The change is written to every environment you are connected to at that moment. An environment that is offline keeps its old value. When a connected environment holds a different value, Settings > General shows a warning that names it. Choose Apply to all to write your current values to every connected environment. The same applies to the new-thread workspace mode and the source control writing style.

A settings change affects future settlement and does not reopen a settled thread. Settings saved by older clients on one device no longer control this behavior.

When you un-settle a thread, it returns to the top of the active list so you can find it right away. Its timestamps do not change. Other threads keep their positions.

Right-click a pull request link in a thread and choose Link to thread to show that pull request in the sidebar. The thread settles when the linked pull request merges if Auto-settle merged threads is enabled. Right-click the same link and choose Unlink from thread to remove it.

On web and desktop, drag a pinned thread to change its position. On mobile, open the thread's menu and choose Move up or Move down. The order is stored by the server and appears on your other connected devices.

If reordering is unavailable for one environment, update the T3 Code server running in that environment. Older servers can still pin and unpin threads, but do not understand synced ordering; their pinned threads keep the default newest-first order below the ones you have arranged.

Add a project by dropping a folder

In the desktop app, drag a folder from your file manager onto the sidebar. T3 Code opens Add project with that folder already filled in, so you confirm it with Add or Enter. An empty sidebar says so next to its Add project button.

The folder is added to this device's environment, the one the desktop app runs itself. To add a folder that lives on another machine, use Add project and browse that environment instead.

Browsers do not tell an app where a dropped folder lives on disk, so the sidebar in a browser tab is not a drop target. Use Add project there.

Panel motion

The main sidebar, right panel, and terminal drawer open and close immediately by default. Under Settings → Appearance → Motion, move the Panel animations slider above 0 ms to add motion. The duration can be set up to 400 ms. Clicking the preview replays all three panel transitions; at 0 ms, it snaps between the same open and closed states.

Environment artwork

Dev and Nightly environments can identify themselves with artwork at the top of the sidebar and in the send button. Choose Artwork, Version pill, or None in Settings under environment identification. Artwork is recolored to match each built-in theme. Custom themes use the Version pill fallback because their colors are not controlled by T3 Code.

To generate a fresh title from the conversation, open a thread's context menu and choose Regenerate title. While T3 Code is generating it, the action reads Regenerating… and cannot be selected again. The option is hidden when the connected environment needs a server update.