documentation
learn how to use, build, and extend trifecta.
getting started
introduction
what is trifecta and how it works
installation
set up the desktop server
pairing
connect your mobile device
first steps
create your first thread
mobile clients
ios app
swiftui client guide
android app
jetpack compose client guide
configuration
server profiles and settings
troubleshooting
common issues and fixes
desktop server
server setup
install and run the server
agent configuration
codex, claude, opencode
environment variables
configure server options
logs and debugging
monitor server activity
protocol
websocket connection
connection lifecycle and heartbeat
effect rpc
wire format and message types
streaming topics
shell and thread subscriptions
error handling
defects, reconnects, and retries
authentication
pairing flow
url parsing and token exchange
bearer tokens
session management and storage
ws tokens
short-lived websocket tokens
security
encryption and best practices
git integration
git lite
mobile git operations
vcs status
branch and working tree info
stacked actions
commit and push workflows
diff viewer
reviewing changes on mobile
need help?
if you cannot find what you are looking for, reach out to the team or join the community discussions.