🚀 Ｔｈｅ Ｐｒｏｂｌｅｍ

When you work with AI coding assistants (like Cursor, Claude Engineer, Aider, OpenCode), they lack shared context. Switching from one agent to another means losing your current tasks, architectural decisions, recent changes, and state.

🌟 𝕎𝕙𝕒𝕥 𝕚𝕤 𝔸𝕘𝕖𝕟𝕥𝕆𝕏?

AgentOX is a continuity layer designed to seamlessly bridge the gap between different AI assistants. It creates a robust, file-based memory layer (.agentos/) directly in your project repository.

Whenever you switch assistants, AgentOX generates a highly-condensed bootstrap handoff prompt containing:

• Pending Tasks
• Hard Architectural Decisions
• Recent History & Git changes
• Architecture Mapping

Your next AI agent can immediately pick up where the last one left off!

⚡ 𝓕𝓮𝓪𝓽𝓾𝓻𝓮𝓼

• 🧠 Shared Memory State: Maintain task lists, goals, and architectural decisions across sessions.
• 🔄 Seamless Handoffs: Automatically generate a "bootstrap" prompt for your next AI agent via agentox switch <agent>.
• 📸 Intelligent Snapshots: Take snapshots of your workspace before handing it over to another agent.
• ☁️ Cloud Sync: Push and pull your state seamlessly across devices with AgentOX Cloud.
• 🛡️ Hard Decisions: Enforce architectural guidelines that AI agents are strictly instructed not to override (--hard).
• 🔗 Git Integration: Automatically logs AI agent activity into the execution log on every git commit.

🛠️ 𝕀𝕟𝕤𝕥𝕒𝕝𝕝𝕒𝕥𝕚𝕠𝕟

New features 🔥

• Cloud Sync & Dashboard (agentox push / agentox cloud-pull)
• Auth module integration for secure cloud access
• Zero-git file watching
• Works on cloned repos
• VSCode/Cursor/Windsurf extension
• Auto-starts on folder open
• One-click agent switch

Install CLI:

npm install -g agentox

Install Extension: Available on the Open VSX Registry and Visual Studio Marketplace. Search for "AgentOX" in your IDE's extension marketplace (VS Code, Cursor, Windsurf) and install it.

💻 𝕀𝔻𝔼 ℂ𝕠𝕞𝕡𝕒𝕥𝕚𝕓𝕚𝕝𝕚𝕥𝕪

| IDE / Tool | MCP Auto | Bootstrap Fallback | |------------|----------|--------------------| | Claude Code | ✅ Native | ✅ | | Cursor | ✅ Native | ✅ | | Windsurf | ✅ Native | ✅ | | Antigravity | ✅ (via MCP config) | ✅ | | VS Code + Copilot | ❌ (needs Cline/RooCode) | ✅ | | ChatGPT | ❌ | ✅ | | Any other AI | ❌ | ✅ |

AgentOX works everywhere via Bootstrap fallback. MCP gives you zero-paste automation in supported IDEs.

📚 𝗤𝘂𝗶𝗰𝗸 𝗦𝘁𝗮𝗿𝘁

1. Initialize AgentOX in your project

Navigate to your existing project repository and run:

agentox init

This creates the .agentos/ directory and sets up the continuity layer, including a Git post-commit hook for tracking changes.

2. Set your current Agent

agentox use claude

(Options: claude, cursor, aider, opencode)

3. Track Tasks and Decisions

# Add pending tasks
agentox task add "Build the login authentication flow"
agentox task add "Setup PostgreSQL database"

# Mark a task as done
agentox task done 1

# Enforce an architectural decision
agentox decision add "Use strictly React and functional components" --hard

4. Switch to a new Agent

If you want to move from your current IDE/agent to another (e.g., from Cursor to Claude), use:

agentox switch cursor

This command auto-saves a snapshot, generates a Bootstrap Prompt, copies it to your clipboard, and sets the active agent.

5. Check Status

agentox status

Displays the current state, active agent, pending tasks, recent decisions, and file tree drift.

📖 𝐂𝐨𝐦𝐦𝐚𝐧𝐝 𝐑𝐞𝐟𝐞𝐫𝐞𝐧𝐜𝐞

| Command | Description | |---|---| | agentox init | Initializes AgentOX in the current repo, setting up state files and git hooks. | | agentox status | Displays the current agent status, tasks, and system state. | | agentox use <agent> | Sets the active agent without generating a handoff prompt. | | agentox switch <agent> | Snapshots state, generates a handoff prompt, copies it, and sets active agent. | | agentox task add/done/list | Manage your agent's pending and completed tasks. | | agentox decision add/list | Manage architectural decisions. Use --hard to make them strict for AI. | | agentox snapshot | Manually captures a snapshot of the workspace and state. | | agentox rollback | Reverts the workspace to a previous snapshot. | | agentox push | Syncs your current agent state to AgentOX Cloud. | | agentox cloud-pull | Pulls your agent state from AgentOX Cloud. | | agentox log-commit | Logs git commits to the execution history (used mainly by the auto-hook). | | agentox repair | Validates and fixes corrupted .agentos/ JSON state files. |

🤝 𝓒𝓸𝓷𝓽𝓻𝓲𝓫𝓾𝓽𝓲𝓷𝓰

We welcome contributions to expand AgentOX to more platforms, improve the prompt templates, and enhance state tracking!

1. Fork the repo.
2. Clone it locally and run npm install.
3. Create a feature branch: git checkout -b feature/my-cool-idea.
4. Commit your changes: git commit -m "Add cool idea".
5. Push to the branch: git push origin feature/my-cool-idea.
6. Open a Pull Request!

📄 𝕃𝕚𝕔𝕖𝕟𝕤𝕖

This project is licensed under the MIT License. See the LICENSE file for details.