Agent Usage Fetcher

About

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Agent Usage Fetcher - Visualize AI Service Usage
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Monitor and display usage limits for AI services like Claude in real-time.
See "How much is left?" at a glance.


【Recommended for】

✓ Daily Claude AI or Codex (ChatGPT) users
✓ Want to use without worrying about session or weekly limits
✓ Need to constantly monitor remaining usage
✓ Tend to forget reset times
✓ Have experienced hitting usage limits


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Main Features
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

■ Real-time Usage Display

Display usage rate (percentage) in real-time on the extension badge.
Monitor your usage status anytime while browsing.

• Session usage rate: How much you've used in the current session
• Weekly usage rate: Cumulative usage for this week
• One-click switching between display types


■ Intuitive Visual Display

Badge color automatically changes based on usage rate.

🟢 Green: Plenty available
🟡 Yellow: Caution
🔴 Red: Nearly depleted

Prevent overuse before it happens.


■ Detailed Usage Information

Open the popup to see more details:

• Current usage and limits
• Usage rate percentage
• Session and weekly reset times
• Time remaining until reset (countdown display)


■ Efficient Data Retrieval

Lightweight and fast data retrieval.
Uses already-open pages when available, only fetches in background when needed.
Auto-fetch can be toggled ON/OFF.


■ Auto-update Function

Automatically fetches usage data.
Always displays the latest information.

Automatically re-fetches data at reset time,
so you can check new usage status immediately after reset.


■ Notifications

• Alerts when usage rate exceeds a threshold
• Notifications when session or weekly limits reset
• Toggle notifications ON/OFF and customize thresholds


■ Error Detection and Login Verification

• Auto-detection and warning for logged-out state
• Error notification only on consecutive failures (not for temporary errors)


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
How to Use
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

【After Installation】

1. Log in to Claude AI or Codex (ChatGPT)
   (Login required in your target browser)

2. Extension automatically starts fetching data

3. Usage rate displays in browser toolbar


【Basic Operations】

• View badge: Check usage rate at a glance
• Hover over icon: Display brief information
• Click icon: Show detailed information in popup
• Buttons in popup: Switch which service/type to show in badge
• Refresh button: Manually re-fetch data


【Settings】

Right-click the extension icon and select "Options" to open the settings page.

• Toggle auto-fetch ON/OFF
• Change fetch interval (default: 3 minutes)
• Select badge display type (Claude/Codex × session/weekly)
• Customize badge colors
• Notification settings (usage threshold alerts, reset notifications)


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Supported Services
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

【Currently Supported】
• Claude AI
• Codex (ChatGPT)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
FAQ
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Q. Is login required?
A. Yes. You must be logged in to the target AI service in your browser.

Q. Where is data stored?
A. All data is stored in your browser's local storage. Nothing is sent to external servers.

Q. Why does a background window open?
A. To fetch usage data. If you already have the page open manually, no new window will be created.

Q. Is it free?
A. Yes, completely free.

Q. Will you support other AI services?
A. Yes, planned for future updates.