Storage Management
Monitor your document usage, understand what counts toward your quota, and free up space when needed.
Understanding Your Quota
Your document quota tracks the total number of knowledge items stored across all your spaces. Every piece of content you ingest — whether manually, via MCP, or through git sync — counts as one document.
Manual Items
Knowledge items you create via the MCP memory_ingest tool or import from files.
Git Sync Data
Commits and pull requests synced from connected GitHub repositories. These are stored in special git spaces.
Task-Linked Data
Git data linked to tasks (commits referencing issues) is protected and never cleaned up automatically.
Plan Limits
| Plan | Documents | Spaces | Storage |
|---|---|---|---|
| Free | 200 | 3 | 50 MB |
| Pro | 5,000 | Unlimited | 1 GB |
| Enterprise | 10,000 | Unlimited | 2 GB |
What Are Git Spaces?
When you connect a GitHub repository and run git_sync, ContextForge creates a git space to store the synced commits and pull requests. Each sync creates knowledge items inside that space.
Over time, if you sync frequently, these git spaces can accumulate and consume a significant portion of your document quota. For example, a repository with active development might generate hundreds of documents from commit and PR data.
Good to know
Git spaces older than 30 days that aren't linked to any tasks are safe to clean up. You can always re-sync your repository to get fresh data when you need it.
Cleaning Up Storage
The Storage Management page lets you review and clean up old git sync data. Here's how it works:
Go to Storage Management
Navigate to Dashboard → Storage or click the "Manage Storage" button on the usage warning banner when it appears.
Review your usage
The page shows your current document count, total git spaces, old git spaces (older than 30 days), and how many documents would be freed by cleaning up.
Clean up old git data
Click the "Clean Up Old Git Data" button to remove git spaces older than 30 days. Your document count updates immediately.
What Gets Protected
The cleanup process is designed to be safe. It will never delete:
- Regular spaces — All manually created spaces and their knowledge items are always safe.
- Task-linked git data — Git spaces containing commits or PRs linked to your tasks are preserved so your task activity history stays intact.
- Recent git spaces — Only git spaces older than 30 days are eligible for cleanup. Recent syncs are always kept.
- Projects and tasks — Your projects, tasks, and connected repositories are never affected by storage cleanup.
Usage Warnings
ContextForge shows you warnings as you approach your limits:
Normal usage. No warnings displayed.
"Approaching Usage Limits" banner appears on the dashboard with a link to manage your storage.
"Usage Limit Reached" — new ingestions will be blocked until you free up space or upgrade your plan.
Tips for Managing Storage
Sync selectively
Only sync repositories you actively need. Each sync creates documents that count toward your quota.
Clean up periodically
Check the Storage Management page monthly to remove old git data you no longer need.
Re-sync when needed
After cleaning up, you can always re-sync a repository to get the latest commits and PRs again.
Upgrade for more space
If you consistently need more documents, consider upgrading to Pro (5,000 docs) or Enterprise (10,000 docs).