Repository navigation
AI Usage
See how much of your AI plan's limits you have used: Claude Code's and Codex's 5-hour and weekly limits, right in the status bar. You know before an agent stops halfway through a task.

Claude Code is past 80% of its weekly limit, so its numbers turn orange; Codex has plenty left.
For each agent you use, a short mark (CC for Claude Code, Cx for Codex), a small bar and the numbers:
42% 2h 15m · 83% 2d 4h
means 42% of the 5-hour limit is used and it resets in 2 hours 15 minutes, and 83% of the weekly limit is used and it resets in 2 days 4 hours. The times count down as you watch. When Claude Code's plan also has a weekly limit for one model, such as Fable, it follows with its name: · 57% Fable 2d 4h. The bar shows the fullest limit; hover for each limit's name. From 80% the numbers turn orange, from 95% red.
Click it for the details: each limit with a bar and when it resets ("Resets in 2h 15m"), the plan (such as max or plus), and Refresh. Usage settings... opens Settings.
If an agent shows signed out, start it once in a terminal so it signs in again. no data means the agent has not recorded any usage yet (Codex records it after its first answer).
Settings > AI > Usage in status bar: Hidden (the default), Right (next to the notifications) or Left (after the repository and branch). Hidden reads nothing at all, so pick Right or Left to see your usage.
Settings > AI > Show usage of has a box per agent, Claude Code and Codex, both on by default. Turn one off to leave it out of the status bar; its usage is then not read at all (for Claude Code: no Keychain and no request to Anthropic).
-
Claude Code: Nibtree asks Anthropic, with the sign-in Claude Code itself keeps in your macOS Keychain. The first time, macOS asks whether Nibtree may use "Claude Code-credentials"; choose Always Allow so it does not ask again. The sign-in is read only to ask for the numbers: it is never saved by Nibtree and never sent anywhere but
api.anthropic.com. If you say no, Nibtree does not ask again until you click Refresh. -
Codex: Nibtree reads the limits Codex writes into its own session files in
~/.codex. Nothing is sent anywhere.
The numbers are read every 5 minutes while the window is open, a little after an agent finishes, and when you click Refresh. Only agents set up on this Mac are shown (their ~/.claude or ~/.codex folder exists).
These pages are generated from docs/wiki. To correct something, open a pull request against the source file; edits made here are overwritten.
Using Nibtree
- Getting Started
- Welcome Screen
- Workspaces
- Files Panel
- File Operations
- File Icons
- Rounded Panels
- Editor and Tabs
- Pin Reorder and Wrap Tabs
- Single Tab Title
- Split Editor
- New File and Unsaved Changes
- Unload Hidden Tabs
- Editing Code
- Code Appearance
- Markdown Editor
- Image and PDF Preview
- Search Everywhere
- Recent Files
- Navigation Bar
- Find and Replace
- Changes and Commits
- Sign In Prompts
- Commit Box Layout
- Repository Actions
- Commit Options
- Ignoring Files
- Diffs
- Inline Diffs
- Staging View
- Revert a Change
- Resolving Conflicts
- Merge Tool
- Blame
- History and Log
- Merge Commits
- Branches and Tags
- Branches Popup
- Remotes
- Stashes
- Shelf
- Git Menu
- Git Dialogs
- Interactive Rebase
- Worktrees
- AI Agents
- AI Tasks
- AI Usage
- Keep Computer Awake
- Submodules
- Git LFS
- GitHub
- Git Console
- Terminal
- Terminal Features
- Scripts
- Navigation
- Menus
- Settings
- Settings Search
- Color Themes
- Settings Terminal and Automation
- Settings Files
- Updates
- Status Bar and Help
- Notifications
- Memory Use
- Clear Cache
- MCP and CLI
- Git Mergetool
- Keyboard Shortcuts
- Keyboard Shortcuts Editor
- Troubleshooting
- Troubleshooting Git
Developers
- Developer Guide
- Architecture
- Project Layout
- Backend
- How Folder Watching Works
- Folder Watching Bugs We Fixed
- How Workspace Files Work
- How the Preview Scheme Works
- Backend Services
- How Terminal Features Work
- Terminal Bugs We Fixed
- Frontend
- How the Rich Markdown Editor Works
- Rich Markdown Bugs We Fixed
- Git Menu Links
- Menu Keys and Routing
- Frontend Modules
- Blame Bugs We Fixed
- Project Color And Title Bar
- One Diff View
- Diff Bugs We Fixed
- Merge Tool Layouts
- Merge Tool Bugs We Fixed
- Color Theme Bugs We Fixed
- How the Connected Diff Works
- Rounded Panels Bugs We Fixed
- Update Bugs We Fixed
- Status Bar Bugs We Fixed
- MCP and CLI Bugs We Fixed
- Repository Actions Bugs We Fixed
- How the Changes Tab Works
- CodeMirror Patterns
- How the Cursor Works
- How Editor Features Work
- How the Path Bar Works
- Commands and Events
- Settings Reference
- Commands Workspace and Changes
- Commands Branches and Remotes
- Commands History and Extras
- Commands App and Tools
- Testing
- Test Suites
- Debugging
- Debugging with MCP
- Measuring Setting Memory
- How Terminal Memory Is Measured
- How Markdown Diagrams Work
- Releases and CI
- Publishing the Wiki
- Versioning and Changelog
- Browser Version Packages
- Browser Release Checks
- Docker Image
- Platforms and Signing
- Windows Support
- Windows Bugs We Fixed
- Windows MCP and CLI
- Docs and Screenshots
- UI Library
- UI Library MCP
- UI Library Bugs
- UI Library Migration
- Contributing
How features work
- Welcome screen
- Workspaces and folders
- Files panel
- File operations
- File icons
- Editor and tabs
- Pin, reorder and wrap tabs
- Single tab title
- Split editor
- New File and unsaved changes
- Unload hidden tabs
- Editing code
- Code appearance
- Markdown editor
- Image and PDF preview
- Search Everywhere
- Recent Files
- Navigation Bar
- Find and replace
- Changes and commits
- Sign-in prompts
- Commit box layout
- Repository actions
- Commit options
- Ignoring files
- Diffs
- Inline diffs
- Staging view
- Revert a change
- Resolving conflicts
- Merge tool
- Blame
- History and log
- Merge commits
- Commit tabs
- Branches and tags
- Branches popup
- Remotes
- Stashes
- Shelf
- Git menu
- Git dialogs
- Interactive rebase
- Worktrees
- AI agents
- AI usage
- Keep computer awake
- AI tasks
- Submodules
- Git LFS
- GitHub account
- Git Console
- Back and Forward
- Integrated terminal
- Scripts tool window
- Menu bar
- Settings
- Search in Settings
- Color themes
- Rounded panels
- Updates and release channels
- Status bar and help links
- Notifications
- Memory readout and memory log
- Clear Cache
- MCP server and command line tool
- git mergetool mode