Skip to content

tang0758/AgentContextFlow

Repository files navigation

๐ŸŒŠ AgentContextFlow (CXF)

English | ็ฎ€ไฝ“ไธญๆ–‡

The universal context exchange bridge for AI agents. Seamlessly transfer, backup, and restore conversation history between Claude, Gemini, and Web UIs.

๐Ÿš€ Why AgentContextFlow?

AI agents often "lose their memory" when a session gets too long (context limit) or when you need to switch tools. AgentContextFlow (using the CXF protocol) provides a smart-summary approach to move your development context anywhere.

โœจ Key Features

  • Smart-Summary: Keeps raw dialogue while summarizing heavy tool outputs to save tokens.
  • Auto-Detection: CLI automatically recognizes Gemini CLI logs, Claude exports, and CXF JSON.
  • Zero-Dependency: Bundled into a single 120KB file. Install and run instantly.
  • Browser Superpowers: A one-click bookmarklet to grab chats from Claude.ai or ChatGPT.com.
  • Agent Skill: Deeply integrates into Gemini CLI as a native skill.

๐Ÿ› ๏ธ Installation

As a Gemini CLI Skill (Recommended)

gemini skills install https://github.com/your-username/AgentContextFlow

After installation, type /skills reload in your session.

As a Global CLI Tool

npm install -g .

๐Ÿ“– Usage Scenarios

Scenario 1: Web to Agent (Web -> Gemini)

  1. Run cxf connector bookmarklet to get your scraper code.
  2. Save it as a browser bookmark.
  3. Click it on a Claude/ChatGPT page to download the .json backup.
  4. Tell Gemini CLI: "Import this backup file."

Scenario 2: Memory Recovery (Gemini -> Gemini)

When a session gets slow or full:

  1. Say: "Backup this conversation."
  2. AI generates a backup.md file.
  3. Open a fresh terminal and say: "Read backup.md and continue from where we left off."

Scenario 3: Cross-Model Sprint (Gemini -> Claude Code)

  1. Export your Gemini context as .md using the skill.
  2. Open Claude Code and say: "Read backup.md to understand my previous work with Gemini."
  3. Claude instantly gains the full context of your project architecture and decisions.

๐Ÿงฐ Developer Guide

  • Build: npm run build (Automatically syncs to skill folder)
  • Test: npm test
  • Bundle: npm run bundle (Generates self-contained dist/index.js)

๐Ÿ“„ License

MIT

About

๐Ÿš€ The universal context exchange bridge for AI agents. Seamlessly transfer, backup, and restore conversation history between Claude, Gemini, and Web UIs. Zero-config, zero-dependency, pure productivity.

Resources

License

Stars

2 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors