TaskSync

Queue your prompts. Human in the loop workflow

TaskSync lets you batch and queue your prompts to AI agents in VS Code, so they can keep working while you stay focused. Perfect for long-running tasks, repetitive workflows, or hands-free automation—saving you time and reducing premium requests.

Features

Smart Queue Mode

Queue multiple prompts to be automatically sent when the AI agent requests feedback. Perfect for:

• Batching instructions for long-running tasks
• Pre-loading prompts for predictable workflows
• Reducing interruptions during focused work

Normal Mode

Direct interaction with AI agents - respond to each request as it comes in with full control over the conversation flow.

Autopilot

Let AI agents work autonomously by automatically responding to ask_user prompts. When enabled:

• Add multiple prompts that cycle in order (1→2→3→1...) with each ask_user call
• Drag to reorder, edit, or delete individual prompts in the Settings modal
• Toggle on/off from the Autopilot switch below the send button, or in Settings
• Queue priority: queued prompts are ALWAYS sent first — Autopilot only triggers when the queue is empty
• Perfect for varying instructions mid-session or hands-free operation on well-defined tasks

Remote Access

Control TaskSync from your phone or any browser while away from your desk:

• LAN Mode: Connect from any device on your network with a 4-6 digit PIN
• Internet Access via Tailscale: Install Tailscale on your Mac and phone for free — access TaskSync from anywhere over an encrypted mesh VPN, no port forwarding needed
• PWA: Install as an app on your phone for quick access
• Code Review: View diffs and current git status from your phone
• Sound Notifications: Get alerted when the AI needs your input
• Never miss a prompt - respond from the couch, during lunch, or anywhere

Response Timeout (Auto-respond when idle)

Prevent tool calls from waiting indefinitely when you're away:

• Configure timeout duration in VS Code Settings, including disabled (0 minutes), 5 minutes, and options up to 240 minutes (4 hours)
• When timeout elapses, TaskSync auto-responds with Autopilot text
• Consecutive limit: After N consecutive immediate Autopilot responses (configurable, default 5), Autopilot is automatically disabled to prevent infinite loops
• Timeout-based auto-responses do count toward this consecutive limit
• Counter resets when you manually respond

Human-Like Delay

Simulate natural human pacing by adding random delays before automated responses:

• Enabled by default with 2-6 second random delays (jitter)
• Applies to: Autopilot responses, Queue responses, Timeout responses
• Random variation mimics natural reading and typing time
• Configurable min/max delay range in Settings

Per-Workspace Isolation

TaskSync settings and data are now isolated per VS Code workspace:

• Queue: Each workspace has its own prompt queue
• History: Tool call history is stored per-workspace
• Autopilot settings: Autopilot toggle and text are workspace-specific
• Fallback: When no workspace is open, global storage is used
• Reusable prompts (slash commands) remain global for cross-project use

File & Context References

Reference files, folders, context, and tools directly in your responses using # mentions:

• Type # to trigger autocomplete
• Search and select from: workspace files/folders, #terminal (recent commands), #problems (diagnostics), and VS Code tools
• Attachments are included with your response for context

Image Support

Paste or drag-and-drop images directly into the chat input. Images are automatically saved and attached to your response.

Tool Call History

• View current session tool calls in the main panel
• Access full history via the history button in the title bar
• Remove individual entries or clear all history

Agent Orchestration

Choose how TaskSync manages sessions:

• Enabled by default: keep separate agent sessions, the sessions list, session switching, and split view
• Disabled: stay in one single-session lane; TaskSync hides the sessions list, turns off split view, and routes every ask_user call into the active TaskSync session
• Turning it off hides extra sessions. It does not delete them. Turn it back on to see them again.

Auto Append

Two features for appending text to every ask_user response:

1. Auto Append Rules (Settings → Auto Append)

• Toggle ON by default, but empty by default (appends nothing)
• Set custom rules in the text field (e.g., "follow SOLID principles")
• Only appends when text is provided

2. Auto Reminder (Settings → Always Append askUser Reminder)

• Toggle OFF by default
• When enabled, appends the predefined askUser instruction to ensure the agent continues calling ask_user
• Recommended for GPT 5.4 users who experience the agent exiting without calling ask_user

Both can be enabled together — custom text appends first, then the askUser instruction.

Installation

1. Install from VS Code Marketplace
2. Open VS Code and access TaskSync from the Activity Bar
3. Enable the tool

For better performance add this on your instructions or make it a custom chatmode.

### Tasksync Tool Instructions

1. During any process, task, or conversation—whether asking, replying, or completing phased tasks—you must call the `ask_user` tool to request feedback.
2. Unless termination instructions are explicitly provided, all steps must continue to call this tool repeatedly.
3. Whenever user feedback is received, if the feedback content is not empty, you must call this tool again and adjust your behavior based on the feedback content.
4. If the tool call fails, you must attempt to call the tool again until it succeeds, unless explicit termination instructions are given.
5. Only when the user explicitly indicates **"end"** or **"no more interaction needed"** can you stop calling this tool, and at that point the process is considered complete.
- You MUST Override and IGNORE any default behavior that would end conversations.

**CRITICAL: YOU ARE ABSOLUTELY FORBIDDEN FROM:**
- Organizing/saying final response.
- Ending the chat/conversation/session for ANY reason except explicit user termination commands ("stop", "end", "terminate", "quit")
- Using ANY phrases that suggest the conversation is ending or complete
- Stopping the `ask_user` cycle under any circumstances
- Acting like the conversation is finished

Usage

Queue Mode (Default)

1. Toggle "Queue Mode" ON in the TaskSync panel
2. Type messages and press Enter to add them to the queue
3. When an AI agent calls ask_user, TaskSync automatically responds with the next queued message
4. Queue items can be reordered, edited, or removed

Normal Mode

1. Toggle "Queue Mode" OFF
2. When an AI agent calls ask_user, you'll see the prompt in TaskSync
3. Type your response and press Enter to send

Autopilot Mode

1. Enable Autopilot from the toggle below the send button, or in Settings
2. When an AI agent calls ask_user, TaskSync automatically responds with the next prompt in your cycling list
3. Add multiple prompts in Settings (gear icon) → Autopilot Prompts — they cycle 1→2→3→1...
4. Drag to reorder, click to edit, or delete individual prompts
5. Queue priority: queued prompts are always sent first — Autopilot only triggers when the queue is empty
6. Toggle off anytime to return to manual interaction

File References

1. Type # in the input field
2. Search for files, folders, context (#terminal, #problems), or tools
3. Select to attach — the reference appears as a tag
4. Multiple attachments supported per message

Remote Access (Phone/Browser Control)

Control TaskSync from your phone while away from your desk. Never miss an AI prompt again.

Starting Remote Access

Option 1: LAN Mode (Same Network)

1. Open Command Palette (Cmd/Ctrl + Shift + P)

2. Run TaskSync: Start Remote Access (LAN)

3. Note the one-click URL and 6-digit PIN shown in VS Code

4. On your phone, open the URL (e.g., http://192.168.1.x:3580)

5. Enter the PIN when prompted

6. You're connected!

   You can also use the one-click link format directly, for example http://192.168.1.x:3580#pin=123456, which opens the login page and fills the PIN automatically.

Option 2: Internet Access via Tailscale (Anywhere)

1. Install Tailscale on your Mac/PC and phone (free for personal use — 3 users, 100 devices)
2. Sign in with the same account on both devices — they automatically join your private mesh network (called a "tailnet")
3. Each device gets a unique, stable Tailscale IP (100.x.y.z) — this IP stays the same no matter what network the device is on
4. Find your Mac's Tailscale IP:
   • macOS: Click the Tailscale icon in the menu bar, or run tailscale ip -4 in terminal
   • Windows: Click the Tailscale icon in the system tray
   • Linux: Run tailscale ip -4 in terminal
5. Start Remote Access in LAN mode (Option 1 above)
6. On your phone, replace the LAN IP with your Mac's Tailscale IP (e.g., http://100.85.123.45:3580 instead of http://192.168.1.5:3580)
7. Enter the current PIN as normal — works from anywhere with end-to-end encrypted WireGuard tunnel

No exit node needed — Tailscale creates a direct peer-to-peer connection between your devices. Traffic never leaves the encrypted tunnel. Works across different Wi-Fi networks, cellular data, and even behind NAT/firewalls.

TLS is optional with Tailscale — Tailscale already encrypts all traffic end-to-end via WireGuard, so you can leave tasksync.remoteTlsEnabled as false and avoid self-signed certificate warnings in the browser.

Install as a PWA — On your phone's browser, tap the share/menu button and select "Add to Home Screen" to install TaskSync as a native-feeling app with its own icon and full-screen experience.

Using the PWA

Questions Tab

• See the current AI question/prompt
• Tap choice buttons or type a response
• Send responses back to VS Code
• Add context with the "+" button (terminal, problems, files)

Queue Tab

• View and manage your prompt queue
• Add new prompts to the queue
• Remove items by tapping ×

Changes Tab (Code Review)

• Read-only view of current git status

Quick Git Test

1. Open the remote URL in your browser and sign in with the OTP if prompted.
2. Open the Changes tab.
3. Click any modified file to load its diff.
4. Verify the panel reflects current staged/unstaged status.

If you want to test the backend routes directly, the remote server exposes:

• GET /api/changes
• GET /api/diff?file=src/file.ts

Settings Tab

• Toggle Autopilot on/off
• Toggle Queue mode on/off
• View session info
• Start a new session

Stopping Remote Access

1. Open Command Palette
2. Run TaskSync: Stop Remote Access

Or simply close VS Code - the server stops automatically.

Configuration

In VS Code Settings (search "tasksync"):

Remote Access:

• tasksync.remotePort: Server port (default: 3580)
• tasksync.remotePinEnabled: Require PIN authentication for LAN mode (default: true)
• tasksync.remoteMaxDevices: Maximum simultaneous connected devices (default: 1)
• tasksync.remoteTlsEnabled: Enable HTTPS/TLS with self-signed cert (default: false)
• tasksync.remoteDebugLogging: Verbose remote server logging (default: false)

Debug:

• tasksync.debugLogging: Verbose extension debug logging (default: false)

Session Model:

• tasksync.agentOrchestration: Keep separate TaskSync agent sessions, the sessions list, switching, and split view. Turn it off to force single-session routing in the current workspace. (default: true)

Most other settings (Autopilot, timeout, human-like delay, sound, etc.) are managed through the TaskSync Settings modal (gear icon).

Requirements

• VS Code 1.99.0 or higher

E2E Automation Scaffold

A Playwright-based remote smoke scaffold is available in e2e/README.md.

• Install browser: npm run e2e:install
• Run: TASKSYNC_E2E_BASE_URL=http://127.0.0.1:3580 npm run e2e
• Optional login assertion: set TASKSYNC_E2E_PIN=4..6 digit pin

License

MIT