⚡ Conduit

Autonomous "Walk Flow" platform for Antigravity and Gemini AI agents. (v0.42.4)

Conduit bridges Antigravity (autonomous agent) and Gemini (real-time assistant), enabling them to share context and coordinate tasks seamlessly.

🎭 The Duo

🎭 The Conductor Protocol

You talk to Antigravity. Antigravity orchestrates everything else.

        ┌──────────────────┐
        │       YOU        │
        └────────┬─────────┘
                 │ (talk here)
                 ▼
        ┌──────────────────┐
        │   ANTIGRAVITY    │◄─── The Conductor
        └────────┬─────────┘
                 │
                 ▼
             GEMINI

How it works:

• You give me tasks → I update context.json → Gemini reads it
• Real-time context sharing keeps both agents in sync
• You interact with Antigravity; Gemini stays updated automatically

✨ Features

📁 Context Sharing

• Automatically tracks active files and symbols
• Shares context between AI agents via a unified .tisktask/context.json

📋 Tisks to be Tasked

• Track pending, active, and completed work items
• Visual queue in the sidebar
• Walk Flow Stepper: Visualizes the Plan -> Execute -> Test cycle.

🤖 Agent Status

• See which agents are active

🌉 Command Bridge (Autonomous)

• AI agents can trigger commands by writing to .tisktask/commands.json
• Enables true autonomous workflows
• Shadow Mode: Execute commands in a node:18-slim Docker container for safety.
• Live HUD: Displays command output and exit codes in the sidebar.

🔄 Auto-Refresh

• Sidebar updates automatically when context changes
• No manual refresh needed
• Audio Alerts: Subtle notification sounds when an agent switches to a blocked status.

� Getting Started

1. Install the extension from VS Code Marketplace
2. Open a workspace - TiskTask creates .tisktask/ folder automatically
3. Start coding - Context is shared automatically!

📦 Packaging & Manual Installation

To create a standalone installer (.vsix) for TiskTask:

1. Install the VS Code Extension Manager: npm install -g @vscode/vsce
2. Run the package command: vsce package
3. Install the resulting .vsix file via the VS Code Extensions menu (Install from VSIX...).

� Files Created

🛡️ Best Practices

• Locking: Check for the existence of .tisktask/lock before writing. Create it while writing, delete when done.
• Atomic Writes: Agents should read the entire JSON, modify it, and write it back quickly to minimize collisions.
• Intent First: Before executing a major change, agents should update their intent in context.json so other agents can yield.
• Token Hygiene: Keep context.json under 10KB. Move long-form logs or history to a separate history.log.

🔄 Session Initialization

When starting a new session, agents must:

🆕 New Projects (Cold Start)

1. Initialize: Run Trinity: Open Nexus Panel. The extension will seed the .tisktask/ directory.
2. First Sync: Run node TiskTask/agent_bridge.js --agent gemini --bootstrap to establish the first session ID.

📂 Existing Projects

1. Auto-Bootstrap: The workspace automatically runs node agent_bridge.js --bootstrap on open via VS Code tasks.
2. Verify: Check .tisktask/snapshot.json and the terminal summary to see the last known state.

🤖 Agent Integration

Agents use agent_bridge.js to communicate state changes:

1. Start Task: node agent_bridge.js --agent gemini --status working --intent "Implementing Auth"
2. Run Test: node agent_bridge.js --agent antigravity --command "npm test" --approval false
3. Signal Blockage: node agent_bridge.js --agent antigravity --status blocked --intent "Test failure in auth.spec.js"
4. Review Plan: node agent_bridge.js --agent gemini --review 8f2a --critique "Add error handling for 401s" --status needs-revision
5. Respond to Critique: node agent_bridge.js --agent antigravity --respond 8f2a --response "Added try-catch blocks" --status needs-review
6. Complete: node agent_bridge.js --agent antigravity --status idle --intent "Feature verified and complete"

🛤️ Walk Flow (Autonomous Execution)

The Walk Flow is the core loop where Antigravity drives the workspace:

1. Plan: Antigravity updates plans and sets currentTask in context.json.
2. Execute: Antigravity queues a command via agent_bridge.js --command "...".
3. Observe: Gemini reads results.json to validate the output of the execution.
4. Test: Antigravity runs npm test (or equivalent) to ensure no regressions.
5. Verify & Complete: Once tests pass, status is set to idle and the plan is marked done.

️ Troubleshooting

• Revert: Run node agent_bridge.js --revert [n] to undo changes (defaults to last backup).
• Run Summary: Execute node agent_bridge.js --summary to verify fields.
• Reset State: Run node agent_bridge.js --clear to wipe all context and history.
• Archive: Run node agent_bridge.js --archive to move completed plans to history.
• Unignore: Run node agent_bridge.js --unignore to surgically remove .tisktask from .gitignore.
• Remove Task: Run node agent_bridge.js --remove <id> to delete a specific plan or tisk.
• UI Reset: Use the Clear All Data button in the Nexus Panel for a full state wipe.
• Manual Reset: Delete the .tisktask/ directory. The extension will re-initialize it on the next action.

⚙️ Commands

🚀 Roadmap

• [x] Context Compression: Automated summarization of history.json.
• [x] Git-Task Linking: Automatic branch creation per "Tisk".
• [x] Shadow Mode: Containerized command execution.
• [x] Agent Review Loop: Collaborative plan refinement.
• [x] Native UI Overhaul: Adopt vscode-webview-ui-toolkit.
• [x] Walk Flow Timeline: Visual history of completed tasks.

🔐 Security

• All data stays on your machine within the .tisktask directory.

📜 License & Legal

License

MIT License - See LICENSE file for full details.

Copyright (c) 2025 Michael Watkins

Third-Party Services

TiskTask integrates with the following Google AI services:

• Google Gemini API (Terms)
• Google Antigravity Platform (Terms)

Your use of these services is governed by Google's respective Terms of Service and Privacy Policies.

Attribution

Powered by Google Gemini 🔮

This project uses Google's Gemini API and Antigravity platform to provide AI-powered autonomous workflows.

Disclaimer

[!IMPORTANT] TiskTask is an independent software product created by Michael Watkins.

This product is not affiliated with, endorsed by, or sponsored by Google LLC.

Google, Gemini, and Antigravity are trademarks of Google LLC.

Warranty Disclaimer

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. The technology used in TiskTask is experimental and may sometimes provide inaccurate results. Users should exercise discretion before relying on generated content for production use.

Data & Privacy

• Your Code: Stays on your machine in the .tisktask/ directory
• API Calls: Subject to Google's data usage policies (see links above)
• Paid vs Free Tier: Data handling differs based on your Google API tier
  • Paid Google API: Your data is not used to train models
  • Free Google API: May be used to improve Google products

Made with ⚡ by Michael Watkins | Powered by Google Gemini