How techniumlabs/adotui works
adotui is a keyboard-first terminal application for monitoring and acting on pull requests across Azure DevOps organizations and projects. Users configure organizations, load or discover repositories and PRs, browse a grouped PR list, then inspect details, diffs, comments, and pipeline runs or perform review and merge actions. The runtime separates Ink presentation and interaction, app state/data coordination, and Azure REST/authentication. README documents mock mode and setup; some UI and data modules were not sampled, so documented capabilities are represented without asserting unsampled call paths.
Main entry points: azureRest.ts Azure REST operations · App.tsx Terminal app · dataController.ts Data controller · PrTabs.tsx PR detail tabs
Components 23
Terminal experience
- Terminal app
src/app/App.tsx - Org and PR tree
src/app/components/OrganizationTree.tsx - PR detail tabs
src/app/components/PrTabs.tsx - Diff view
src/app/components/diff/DiffBody.tsx - Comments view
src/app/components/CommentsView.tsx - Pipeline runs
src/app/components/PipelineRunsView.tsx - Create PR
src/app/components/CreatePrForm.tsx - Keyboard interaction
src/app/hooks/useAppKeyboard.ts
App coordination
- App state
src/app/hooks/useAppState.ts - PR actions
src/app/actions/confirmActions.ts - Data controller
src/app/dataController.ts
Azure data services
- PR discovery and loading
src/data/azureLoad.ts - PR detail data
src/data/azurePrDetails.ts - Azure REST operations
src/data/azureRest.ts - Diff retrieval
src/data/azureDiff.ts - Comment operations
src/app/hooks/usePrComments.ts - Authentication
src/data/azureAuth.ts
Configuration
- Config and wizard
src/data/config.ts - App and view cache
src/data/cache.ts
Other components
- User
- Azure DevOps
- Azure CLI
- Git diff
Connections 28
- User → Terminal app: navigates
README.md - Terminal app → Keyboard interaction: registers input
src/app/App.tsx - Terminal app → App state: reads state
src/app/App.tsx - Terminal app → Org and PR tree: renders
src/app/App.tsx - Terminal app → PR detail tabs: renders
src/app/App.tsx - Terminal app → Create PR: renders
src/app/App.tsx - User → Config and wizard: configures projects
README.md - Data controller → Config and wizard: loads config
src/app/dataController.ts - Data controller → App and view cache: reads and writes
src/app/dataController.ts - Data controller → PR discovery and loading: loads PR data
src/app/dataController.ts - Org and PR tree → Data controller: displays loaded data
- App state → Data controller: coordinates loading
- PR detail tabs → PR detail data: loads PR details
README.md - PR detail tabs → Diff view: selects diff tab
README.md - Diff view → Diff retrieval: requests diffs
README.md - Git diff → Diff retrieval: computes file diffs
README.md - PR detail tabs → Comments view: selects comments tab
README.md - Comments view → Comment operations: loads and edits
README.md - Pipeline runs → Azure REST operations: fetches runs
- Create PR → PR actions: submits PR
README.md - PR actions → Azure REST operations: performs PR actions
README.md - PR discovery and loading → Azure REST operations: uses REST
README.md - PR detail data → Azure REST operations: uses REST
README.md - Diff retrieval → Azure REST operations: uses REST
README.md - Comment operations → Azure REST operations: uses REST
src/app/hooks/usePrComments.ts - Azure REST operations → Azure DevOps: sends requests
README.md - Azure REST operations → Authentication: gets credentials
- Authentication → Azure CLI: gets access token
src/data/azureAuth.ts