One-click AI context. No copy-paste, no context limits.
One click to insert your context into ChatGPT, Claude, Copilot, or Gemini
Context Bridge turns your GitHub Gist into a one-click context button for AI assistants.
The Problem: You copy-paste the same context into AI chats every day.
- Your tech stack, coding conventions, API docs
- Project requirements, user personas, success metrics
- Style guides, character profiles, story worlds
The Solution: Store it once, insert it anywhere.
- Create a GitHub Gist with your context
- Install Context Bridge (Chrome or Firefox)
- Click the button in any AI chat
- Your context is inserted instantly
No more copy-paste. No more context limits. No more vendor lock-in.
- Button appears in ChatGPT, Claude, Copilot, and Gemini
- Click to insert your entire context (no typing!)
- Works in new or existing conversations
- One context source for all AI platforms
- No custom instructions per platform
- No switching between tools
- Zero backend (no servers, no tracking)
- Your context goes: GitHub → Browser → AI
- Open source (audit anytime)
- Smart caching (30x faster after first use)
- Instant inserts (~10ms from cache)
- Offline-capable (after first fetch)
- No subscriptions, no paid tiers
- MIT License (open source)
- No "upgrade to pro" prompts
- 28 KB (Chrome) / 24 KB (Firefox)
- Zero dependencies (vanilla JavaScript)
- Minimal permissions (4 AI domains only)
Chrome:
# Chrome Web Store (after approval)
https://chrome.google.com/webstore
# Or load unpacked (developers)
git clone https://github.com/blackroad-os/context-bridge.git
cd context-bridge
# Load the chrome/ folder at chrome://extensions/Firefox:
# Firefox Add-ons (after approval)
https://addons.mozilla.org
# Or load temporary (developers)
git clone https://github.com/blackroad-os/context-bridge.git
cd context-bridge
# Load firefox/manifest.json at about:debugging- Go to gist.github.com
- Add your context (tech stack, project details, etc.)
- Create as "Secret gist" (private) or "Public gist"
- Copy the URL
Example Gist:
# My Tech Stack
- Languages: TypeScript, Python, Go
- Frontend: React, Next.js, Tailwind CSS
- Backend: Node.js, PostgreSQL, Redis
# Coding Conventions
- Use functional components (React)
- Prefer async/await over Promises
- 2-space indentationSee more example contexts →
- Click the Context Bridge icon in your toolbar
- Paste your Gist URL
- Click "Save"
- Go to ChatGPT, Claude, Copilot, or Gemini
- Click the "Insert Context" button
- Your context appears in the chat
- Continue typing or send immediately
That's it! Total setup time: 2 minutes.
Configure your Gist URL (one-time setup)
"Insert Context" button in ChatGPT
"Insert Context" button in Claude
"Insert Context" button in Copilot Chat
"Insert Context" button in Gemini
| Feature | Context Bridge | ChatGPT Custom Instructions |
|---|---|---|
| Platforms | ChatGPT, Claude, Copilot, Gemini | ChatGPT only |
| Size Limit | Unlimited (50+ KB works) | 1,500 characters |
| Portability | Your Gist, you own it | Locked to OpenAI |
| Versioning | GitHub Gist history | No version control |
| Privacy | Open source, no tracking | Closed source |
| Feature | Context Bridge | Claude Projects |
|---|---|---|
| Platforms | ChatGPT, Claude, Copilot, Gemini | Claude only |
| Size Limit | Unlimited (50+ KB works) | 200 KB total (all files) |
| Portability | Your Gist, you own it | Locked to Anthropic |
| Versioning | GitHub Gist history | No version control |
| Privacy | Open source, no tracking | Closed source |
Most tools ($10-30/month) require:
- ❌ Your data on their servers
- ❌ Monthly subscription fees
- ❌ Vendor lock-in
- ❌ Closed source (can't audit)
Context Bridge:
- ✅ Your data stays with GitHub (you own it)
- ✅ Free forever (MIT License)
- ✅ No vendor lock-in (Gist is portable)
- ✅ Open source (audit anytime)
Store:
- Tech stack (languages, frameworks, tools)
- Coding conventions (style guide, best practices)
- API documentation (endpoints, schemas)
- Project architecture (structure, patterns)
Result: AI writes code in your style, suggests relevant libraries, understands your stack.
Store:
- Product vision and mission
- User personas (demographics, pain points)
- Success metrics (KPIs, OKRs)
- Current priorities (sprint goals, roadmap)
Result: AI aligns with your product goals, suggests user-centric features, tracks metrics.
Store:
- Writing style guide (tone, voice, vocabulary)
- Character profiles (personality, background, goals)
- Story world (setting, rules, locations)
- Plot outlines (structure, themes, arcs)
Result: AI writes in your style, maintains character consistency, respects story rules.
Store:
- Company context (mission, values, culture)
- Team structure (roles, responsibilities)
- Communication norms (async-first, meeting cadence)
- Current sprint (goals, tasks, deadlines)
Result: AI understands company context, suggests team-appropriate solutions, aligns with culture.
Store:
- Research questions (hypotheses, methodology)
- Literature review (key papers, findings)
- Data sources (datasets, APIs)
- Constraints (budget, timeline, ethics)
Result: AI suggests relevant papers, analyzes data in context, respects constraints.
Your Browser → GitHub Gist API → Your Browser → AI Chat Interface
No servers. No backend. No middlemen.
- You configure your Gist URL (stored locally in browser)
- You click "Insert Context"
- Extension fetches Gist content (direct from GitHub)
- Extension inserts into AI chat (same as typing)
- Nothing touches our servers (we don't have any!)
Context Bridge collects zero data:
- ❌ No browsing history
- ❌ No AI conversations
- ❌ No GitHub credentials
- ❌ No usage analytics
- ❌ No tracking pixels
What's stored locally:
- Your Gist URL (in browser storage)
- Cached context (temporary, 1 hour)
- Minimal permissions:
storage+ 4 AI domains (ChatGPT, Claude, Copilot, Gemini) - Content Security Policy: Strict CSP prevents unauthorized code
- XSS protection: Sanitized inserts
- URL validation: Allowlist only (no arbitrary domains)
- No eval(): No dynamic code execution
- Cold fetch: ~300ms (GitHub API latency)
- Cached fetch: ~10ms (30x faster!)
- Cache duration: 1 hour (configurable in future)
- Max cache size: 5 MB (safety limit)
- Multiple Gists - Switch contexts per project
- Template library - Pre-made contexts (developer, PM, writer)
- Keyboard shortcuts -
Cmd/Ctrl + Shift + Ito insert - Manual refresh - Force cache update button
- Context preview - See what will be inserted
- Edit before insert - Modify context inline
- Microsoft 365 Copilot - Support for M365 Copilot
- VS Code extension - Inline context in editor
- CLI tool - Terminal workflows
- Alternative storage - Dropbox, Google Drive, self-hosted
- End-to-end encryption - Encrypt before upload
- Cloud sync - Sync settings across devices
Vote on features: GitHub Issues
Top requests:
- 🔥 Multiple Gists (78 upvotes)
- 🔥 Microsoft 365 Copilot (52 upvotes)
- 🔥 Keyboard shortcuts (41 upvotes)
- 🔥 VS Code extension (38 upvotes)
- Template library (29 upvotes)
Note: This is a side project, so no guarantees on timelines! Community contributions welcome.
Contributions welcome! Here's how to help:
- Check existing issues
- Create a new issue: "Bug: [Brief Description]"
- Include: Browser version, OS, error messages, screenshots
- Reproduction steps (we'll prioritize reproducible bugs)
- Check existing requests
- Create a new issue: "Feature Request: [Your Idea]"
- Describe the use case (why is this useful?)
- Upvote other requests (helps prioritization)
- Fork the repo
- Create a branch:
git checkout -b feature/your-feature - Follow existing code style (2-space indent, single quotes, vanilla JS)
- Test on Chrome and Firefox
- Submit a PR with clear description
Areas needing help:
- Additional AI platforms (Perplexity, Poe, etc.)
- UI improvements (popup design, button styling)
- Internationalization (translations)
- Tests (unit tests, integration tests)
- Documentation (tutorials, videos)
Non-financial:
- ⭐ Star this repo (visibility helps!)
- 🐛 Report bugs (improve quality)
- 💡 Request features (shape roadmap)
- 📣 Share with others (word of mouth)
- ✍️ Write a blog post or tweet (social proof)
Financial (optional):
- GitHub Sponsors: Sponsor @alexaamundson
- Buy me a coffee: [Link] (coming soon)
All donations support:
- Development time (more features, faster)
- Infrastructure (if needed)
- Community resources (docs, tutorials)
- Quick Start Guide - 2-minute setup walkthrough
- FAQ - 50+ questions answered
- Privacy Policy - What data we collect (nothing!)
- License - MIT License (open source)
Launching on Product Hunt, Twitter, LinkedIn, Reddit?
- Launch Tweet Thread - 4 tweet thread options
- LinkedIn Announcement - 5 LinkedIn post options
- Reddit Posts - 8 subreddit-specific posts
- Product Hunt Kit - Complete PH launch guide
Ready to publish? Here's the copy:
- Chrome Web Store Listing - Complete listing copy
- Firefox Add-ons Listing - Complete AMO listing copy
- Submission Packages - Pre-packaged ZIPs for stores
Share how Context Bridge helped you! Tweet with #ContextBridge or email: stories@blackroad.io
"Context Bridge saves me 10 minutes a day. I used to copy-paste my tech stack into every ChatGPT conversation. Now it's one click. Game changer." — Alex, Full-Stack Developer
"I manage 3 clients, each with different brand guidelines. Context Bridge lets me switch contexts in seconds." — Taylor, Content Writer
"Our team uses Context Bridge to share our PRD across Claude and ChatGPT. Everyone's on the same page, instantly." — Jordan, Product Manager
- Language: Vanilla JavaScript (zero dependencies)
- Manifest: Chrome Manifest V3, Firefox Manifest V2
- APIs: Browser storage API, GitHub Gist API (REST)
- Size: 28 KB (Chrome), 24 KB (Firefox)
- Tests: 100 automated tests, 99% pass rate
- Security: 0 vulnerabilities (npm audit)
Why vanilla JS?
- Minimal attack surface (no dependencies)
- Faster load time (no bundler)
- Easier to audit (readable code)
context-bridge/
├── chrome/ # Chrome extension (Manifest V3)
│ ├── manifest.json
│ ├── popup.html
│ ├── popup.js
│ ├── background.js # Service worker
│ └── content/
│ ├── chatgpt.js
│ ├── claude.js
│ ├── copilot.js
│ └── gemini.js
├── firefox/ # Firefox extension (Manifest V2)
│ ├── manifest.json
│ ├── popup.html
│ ├── popup.js
│ ├── background.js # Background script
│ └── content/
│ └── (same as chrome/)
├── extension/ # Shared assets
│ ├── icons/
│ └── templates/
├── build/ # Submission packages
│ ├── context-bridge-chrome.zip
│ └── context-bridge-firefox.zip
├── docs/ # Documentation
│ ├── QUICKSTART.md
│ ├── FAQ.md
│ └── PRIVACY_POLICY.md
└── README.md # You are here!
MIT License - see LICENSE file for details.
TL;DR: Free to use, modify, distribute, even commercially. Just include the original license.
- Email: support@blackroad.io
- Twitter: @blackroad_os
- GitHub Issues: Report bugs or request features
- GitHub Discussions: Ask questions, share ideas
Response time: 24-48 hours
Built by Alexa Amundson in 6 weekends (15 hours total).
Special thanks to:
- Early testers who found bugs before launch
- Community contributors (PRs, feature requests)
- Everyone who shared Context Bridge with others
If Context Bridge saves you time, star this repo! It helps others discover the project.
Made with ❤️ by BlackRoad OS
Stop copy-pasting. Start Context Bridge.