Agent Usage Fetcher

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
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.

■ 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 between session/weekly display
• Refresh button: Manually re-fetch data

【Settings】

• Toggle auto-fetch ON/OFF
• Change fetch interval (default: 3 minutes)
• Select badge display type (session/weekly)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
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.