Claude Counter User Guide
Complete Reference Manual
This guide covers every feature in Claude Counter. Use the table of contents to jump to specific sections.
Tab 1: Session
The Session tab is your main dashboard for tracking Claude Code sessions.
Session Display
Circular Progress Indicator
- Shows sessions used vs. total available
- Color fills as you use more sessions
- Center displays current count
Sessions Information
- Used: Number of sessions started this period
- Remaining: Sessions still available
- Days Left: Days until your session count resets
Session Timers
Session Duration Timer
- Tracks total time for your current session
- Counts down from your configured duration (default: 5 hours)
- Progress bar shows remaining time visually
- States: Running, Paused, Stopped
Save Progress Timer
- Independent countdown for save reminders
- Default: 4:45 hours
Starting a Session
- Tap the Start Session button
- Confirm in the dialog: "Start New Session?"
- (Optional) Add a description for tracking purposes
- Both timers begin counting down
Session Descriptions
- Tap the description field to add notes
- Use for project names, task descriptions, or client references
- Descriptions are saved with your session history
- Searchable in the History tab
During a Session
Status Indicators
- Green border = Active session
- Timer badges show state
- Progress bars update in real-time
Ending a Session
- Tap the End Session button
- Confirm: "This will stop the current session and all timers"
- Session is saved to history with:
- Start time
- End time
- Total duration
- Your description
Custom Timers Section (Pro)
Pinned custom timers are displayed below the main timers on Tab 1.
Session Limits & Alerts
Free Tier Limits
- 5 sessions
- 1 grace session (6th session with warning)
- After grace session: upgrade required
Tab 2: Timers
The Timers tab provides full management of custom timers (Pro feature).
Timer List
Viewing Timers
- All custom timers displayed in a list
- Each shows: Name, Duration, Current State
- Progress bars for running timers
- Pinned timers appear at top
Creating Timers
- Tap Add Timer or +
- Enter timer name (e.g., "Pomodoro", "Stand-up", "Client Call")
- Set duration using the time picker
- Tap Save
- Tap the pin of a timer to display the timer below the main timers on Tab 1
Timer Ideas
- Pomodoro: 25 minutes work, 5 minutes break
- Stand-up Meeting: 15 minutes
- Code Review: 30 minutes
- Deep Work Block: 90 minutes
Timer Controls
For Each Timer
- Play/Pause: Start or pause the timer
- Reset: Return to full duration
- Edit: Change name or duration
- Delete: Remove the timer
Timer States
- Idle: Not started, shows full duration
- Running: Actively counting down
- Paused: Stopped mid-countdown
- Completed: Reached zero
Pro Feature Lock
Free Users See
- "Pro Feature" badge
- Feature description
- Upgrade button
- No access to timer creation
Tab 3: History
The History tab shows all your session records.
Session List
Each Session Card Shows
- Session number (#1, #2, etc.)
- Date and time range
- Total duration (formatted as Xh Xm)
- Description (if provided)
- Active indicator (green border for current session)
Filtering Sessions
Period Filter
- Current Period: This month's sessions only
- All Periods: Complete history
- Select Periods: Select specific period ranges
Period Selector
- Tap to open period selection sheet
- See all archived periods
- Select multiple periods to combine
Sorting Sessions
Tap the Sort button to order by:
- Date (Newest): Most recent first
- Date (Oldest): Earliest first
- Duration (Longest): Longest sessions first
- Duration (Shortest): Quickest sessions first
- Description (A-Z): Alphabetical
- Description (Z-A): Reverse alphabetical
Searching Sessions
- Use the search bar at top
- Search by:
- Description text
- Date
Session Actions
Delete a Session
- Tap Delete
- Confirm deletion
Note: Deleted sessions cannot be recovered.
Exporting History
- Tap the Export button
- Choose export method:
- Copy to Clipboard: Formatted text report for pasting
- Share as Text: Text format
- Share as CSV: Spreadsheet format
Export Includes
- Report header with generation date
- Period information
- All session records with:
- Session number
- Developer ID
- Date and time
- Duration
- Description
Tab 4: Statistics
The Statistics tab provides analytics and insights about your usage.
Period Filter
Located at the top of the Statistics tab.
Filter Options
- Current Period: This month only
- All: Complete history
- Select Periods: Select specific period ranges
Display Shows
- Selected period range (e.g., "Periods 1 - 13")
- Total session count for selection
Quick Stats Dashboard
Row 1
- Sessions Remaining: Total for period
- Days Remaining: Until period reset
Row 2
- Sessions Today: Count for current day
- Sessions This Week: Count for current 7 days
Row 3
- Sessions Used: Total for period
- Total Time Last 7 Days: Formatted as Xh Xm
Row 4
- Total Time This Period: Complete duration
- Avg Duration: Average session length
Charts
Usage by Seven Days
- Bar chart showing 7-day period totals
- Y-axis: Duration in minutes
- X-axis: Period dates (adaptive labels)
- Purple gradient bars
Session Duration by Date
- Daily session totals
- Individual days with activity
- Blue gradient bars
- Shows actual session dates only
Usage by Day of Week
- Mon through Sun breakdown
- Identifies your most productive days
- Orange gradient bars
Sessions by Hour of Day
- 24-hour distribution
- Shows when you typically work
- Identifies peak coding hours
- Green gradient bars
Insights Section
Longest Session
- Your longest single session
- Duration displayed
Most Productive Day
- Date with most sessions
- Session count shown
Average Duration
- Mean session length
- Across all sessions in filter
Exporting Statistics
- Tap Export Statistics
- Choose method:
- Copy to Clipboard: Formatted text report for pasting
- Share as Text: Text format
- Share as CSV: Spreadsheet format
Text Export Includes
- Quick stats summary
- Period information
- Key metrics
CSV Export Includes
- Session data in columns
- Session Number, Developer ID, Date, Time, Duration, Description
- Ready for Excel, Numbers, or Google Sheets
Tab 5: Options
The Options tab contains all the settings and customization.
Subscription Section
For Free Users
- Shows "Free" status
- Upgrade to Pro button
- Tap to subscribe
For Pro Users
- Shows "Pro" with crown icon
- Subscription management link
- View renewal date
- Manage via App Store
Appearance
Theme Selection
Choose from 15+ themes:
- System (follows iOS)
- Blue, Purple, Green, Pink
- Gold, Orange, Red, Yellow
- Cobalt, Indigo, Dodger Blue
- Gray, Black, Brown
Mode Selection
- Light: Always light appearance
- Dark: Always dark appearance
- System: Follows iOS setting
- Custom: Full theme customization
Timer Settings
Developer ID
- Default: #1
- Unique identifier for enterprise reporting
- Included in all session exports (Tab 3 and Tab 4)
- Set once, applied to all future sessions
- Tap to expand and edit the ID
Session Duration
- Default: 5 hours (300 minutes)
- Set to match Claude Code session length
- Range: 1 minute to 24 hours
Save Progress Timer
- Default: 4:45 hours (285 minutes)
- Reminder to update Claude work progress
- Range: 1 minute to session duration
Session Reset Day
- Default: 1st of month
- Select any day (1-31)
- Aligns with your monthly billing cycle
Language
Available Languages
- English (UK) - British spelling and date formats
- English (US) - American spelling and date formats
- Afrikaans
- Greek (Ελληνικά)
- French (Français)
- Spanish (Español)
- German (Deutsch)
- Dutch (Nederlands)
Changing Language
- Select language
- App immediately updates
Information Links
- About: App version and credits
- Product Page: Marketing website
- Setup Guide: Getting started help
- User Guide: This document
- Terms of Service: Legal terms
- Privacy Policy: Data handling
Widgets
Lock screen widgets provide at-a-glance information (Pro feature).
Available Widgets
Sessions Remaining
- Number of sessions available
- Updates after each session
- Shows limit context
Days Remaining
- Days until your session counter resets
- Shows next reset date
- Progress ring shows period elapsed
Session Timer
- Shows remaining session time
- Updates during active sessions
- Displays paused state when paused
Save Progress Timer
- Countdown to save reminder
- Independent of session timer
- Shows remaining minutes
Adding Widgets
- Long-press Lock Screen
- Tap Customize
- Select Lock Screen
- Tap widget area
- Scroll down to "Claude Counter"
- Tap on "Claude Counter"
- Initially swipe left to view the widgets one by one
- Tap and hold the widget you want to add and then drag it to the widget area
- For the Sessions Left and Days Until Reset tracking the circular widgets are popular
- For the Next Session and Save Progress tracking the smaller square widgets are popular
- Popular widget order: Next Session, Save Progress, Sessions Left, Days Until Reset
- Tap Done
Widget Behavior
Active Timers
- Update every minute
- Show live countdown
Subscription
Free Tier
Includes
- 5 sessions
- 1 grace session
- Basic session tracking
- Session timers
- 30 days of history
- 30 days of statistics
Pro Tier
Includes
- 50 (Unlimited) sessions per month
- Unlimited custom timers
- Lock screen widgets
- Full history (unlimited)
- Full statistics (unlimited)
- Data export (text & CSV)
- All future Pro features
Pricing
- Monthly: $4.99/month
- Annual: $39.99/year (33% savings)
Subscribing
- Go to Settings > Subscription
- Tap Upgrade to Pro
- Select Monthly or Annual
- Tap Subscribe Now
- Confirm
- Pro features unlock immediately
Managing Subscription
- Go to Settings > Subscription
- Tap Manage Subscription
- Opens App Store subscription settings
- Change plan or cancel
Restoring Purchases
If you reinstall or switch devices:
- Go to Settings > Subscription
- Tap Restore Purchases
- Sign in with Apple ID if prompted
- Pro status restores automatically
Tips & Best Practices
For Individual Developers
- Always confirm before starting a session
- Add descriptions to track what you worked on
- Review weekly stats to understand your patterns
- Use save timer to commit progress before session ends
- Create custom timers for your workflow
For Employees
- Set Developer ID in Timer Settings for team reporting
- Tag sessions with project codes
- Export weekly for management reports
- Use period filtering for monthly summaries
- Track time consistently for accurate reporting
For Contractors
- Description = Client/Project for billing
- Export CSV for invoicing
Timer Strategies
Pomodoro Technique
- Create 25-minute work timer
- Create 5-minute break timer
- Alternate for focused productivity
Deep Work Blocks
- Create 90-minute timer
- No interruptions during block
- Review progress after
Meeting Timers
- Stand-up: 15 minutes
- 1:1: 30 minutes
- Planning: 60 minutes
FAQ
Sessions
Q: What counts as a tracked session?
A: Each time you tap "Start Session" and confirm, one session is used.
Q: What's the grace session?
A: After using 5 free sessions, you get 1 additional session before needing to upgrade.
Q: When do sessions reset?
A: On your configured reset day (default: 1st of month).
Timers
Q: Why two timers?
A: Session timer tracks total time; save timer reminds you to commit work or update Claude progress.
Q: Can I change timer durations mid-session?
A: Changes apply to new sessions, not the current one.
Q: Do timers run in the background?
A: Yes, timers continue when the app is backgrounded.
Data
Q: Where is my data stored?
A: On your device only.
Q: Can I backup my data?
A: Data is included in iOS backups.
Q: What happens if I delete the app?
A: All session data is permanently deleted.
Subscription
Q: Can I try Pro for free?
A: The free tier lets you evaluate the app. Upgrade when ready.
Q: Can I downgrade from Pro?
A: Cancel subscription; you keep Pro until period ends, then revert to Free.
Q: Do I lose data if I downgrade?
A: No, data is retained. Access to some features becomes limited.
Getting Help
Last Updated: December 2025
Claude Counter Version 26.0
Still Need Help?
Can't find what you're looking for? We're here to assist!