diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..bdf86a7
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,147 @@
+# Agents Documentation
+
+This file tracks the usage, improvements, and evolution of OpenCode agents in this project.
+
+## Agent Overview
+
+### Available Agents
+
+| Agent | Mode | Purpose | Last Updated | Usage Count |
+|--------|------|---------|--------------|-------------|
+| sessionsummary | subagent | Generates structured session summaries for GEMINI.md | 2025-11-11 | 3+ |
+| build | primary | Full development work with all tools | - | - |
+| plan | primary | Planning and analysis without making changes | - | - |
+| general | subagent | Research and multi-step tasks | - | - |
+| cleanup | subagent | Repository cleanup and organization | - | - |
+| docs-writer | subagent | Technical writing and documentation | - | - |
+| review | subagent | Code review and quality assessment | - | - |
+| security | subagent | Security auditing and vulnerability analysis | - | - |
+
+## Session History
+
+### 2025-11-10 (Initial Session)
+**Agents Used**: sessionsummary (manual implementation)
+
+**Session Summary**:
+- Fixed urllib3 SSL compatibility warning by downgrading from 2.5.0 to 1.26.20
+- Created initial sessionsummary agent (incorrect Python implementation)
+- User corrected approach to use OpenCode.ai agent guidelines
+- Created proper sessionsummary agent in `.opencode/agent/` following OpenCode.ai specifications
+
+**Agent Improvements**:
+- Learned to follow OpenCode.ai agent guidelines instead of custom implementations
+- Established proper agent configuration with YAML frontmatter and permissions
+
+---
+
+### 2025-11-11 (Dashboard Fix Session)
+**Agents Used**: sessionsummary (manual), sessionsummary (subagent)
+
+**Session Summary**:
+- Started new Gemini session
+- User requested file organization with .temp folder
+- Created .temp folder and updated .gitignore
+- Moved example files to .temp folder
+- Fixed critical DashboardDataFetcher path resolution error
+- Added session summaries to GEMINI.md
+
+**Key Technical Fix**:
+- **Issue**: `DashboardDataFetcher - ERROR - Failed to fetch or save account status: [Errno 2] No such file or directory`
+- **Root Cause**: Path resolution issue when running as subprocess from main_app.py
+- **Solution**: Used absolute paths with `os.path.dirname(os.path.abspath(__file__))`
+- **Result**: DashboardDataFetcher now works correctly
+
+**Agent Improvements**:
+- Enhanced sessionsummary agent usage for better documentation
+- Improved file organization practices
+- Established better debugging workflow
+
+---
+
+## Agent Configuration Details
+
+### sessionsummary
+**File**: `.opencode/agent/sessionsummary.md`
+
+**Configuration**:
+```yaml
+---
+description: Analyzes development sessions and generates structured summary reports for GEMINI.md
+mode: subagent
+model: anthropic/claude-sonnet-4-20250514
+temperature: 0.1
+tools:
+  write: true
+  edit: true
+  bash: false
+permission:
+  bash: "deny"
+  webfetch: "deny"
+---
+```
+
+**Purpose**: Analyzes development sessions and generates structured summary reports for GEMINI.md
+
+**Key Features**:
+- Follows exact session summary format as specified
+- Integrates with GEMINI.md automatically
+- Provides structured analysis of session objectives, accomplishments, decisions, and next steps
+- Uses proper OpenCode.ai agent configuration with permissions
+
+**Usage**: `@sessionsummary please analyze our current session and add summary to GEMINI.md`
+
+---
+
+## Agent Improvement Ideas
+
+### Potential Enhancements
+
+1. **Automated Session Detection**
+   - Automatically detect when sessions start/end
+   - Prompt for session summary creation
+   - Track session duration and productivity metrics
+
+2. **Enhanced sessionsummary Agent**
+   - Add code analysis capabilities
+   - Track git commits during session
+   - Generate metrics on lines of code added/removed
+
+3. **Cross-Session Analytics**
+   - Track most frequently used agents
+   - Identify common patterns in development work
+   - Generate productivity reports
+
+4. **Integration with Project Tools**
+   - Auto-detect files modified during session
+   - Link to specific commits/PRs
+   - Integrate with issue tracking
+
+### Agent Usage Statistics
+
+**Total Sessions Documented**: 2  
+**Most Used Agent**: sessionsummary (100%)  
+**Average Session Length**: 2-3 hours  
+**Common Themes**: Bug fixes, file organization, documentation  
+
+---
+
+## Maintenance
+
+### Updating This File
+
+This AGENTS.md file should be updated:
+- At the end of each session where agents are used
+- When new agents are created or modified
+- When agent configurations are changed
+- When significant agent improvements are implemented
+
+### Agent File Locations
+
+- **Agent Definitions**: `.opencode/agent/`
+- **Agent Usage Logs**: This file (AGENTS.md)
+- **Session Summaries**: `GEMINI.md`
+
+---
+
+*Last Updated: 2025-11-11*  
+*Next Review: After next agent usage session*
\ No newline at end of file