Sidequest

Sidequest is a VS Code extension for planning development work as Markdown Quests and tracking agent execution in separate Agent Run documents. All data is stored in the current workspace under .sidequest/, so it remains easy to review, version, and share with Git.

Quick Start

1. Open a project folder in VS Code.
2. Open the Command Palette (Ctrl+Shift+P / Cmd+Shift+P) and run Sidequest: Initialize Workspace.
3. Run Sidequest: New Quest and enter a title.
4. Select the Quest from the Sidequest Activity Bar view and edit it in VS Code's standard Markdown editor.
5. Run Sidequest: Copy Agent Prompt to create the Agent Run document and copy an execution prompt.

Initialization creates this workspace structure:

.sidequest/
├─ quests/      # Quest specifications
└─ agent-runs/  # Agent execution records

Writing a Quest

Quests are ordinary Markdown files using the following format:

---
schema: 2
id: SQ-0001
title: Fix the login error
status: open
created_at: 2026-08-02T10:00:00+09:00
updated_at: 2026-08-02T10:00:00+09:00
tags:
  - bug
---

# Problem

Describe the problem to solve.

# Goal

Describe the expected result when the Quest is complete.

# Implementation Guidance

Describe constraints, design guidance, tests, or conventions to follow.

Problem and Goal are required. Implementation Guidance is optional. When a Quest is saved, Sidequest reparses the file and refreshes the Tree View and diagnostics automatically.

Agent Workflow

1. Select a Quest and run Sidequest: Select Active Quest to make it the active task.
2. Run Sidequest: Copy Agent Prompt. Sidequest creates a matching document under .sidequest/agent-runs/ and copies the prompt to the clipboard.
3. The agent follows the Quest's Problem, Goal, and Implementation Guidance.
4. Record Progress, Changed Files, Validation, Token Usage, and Remaining work in the Agent Run document.
5. When implementation is ready for human review, leave the Quest in review; use blocked when additional decisions or work are required.

Use Sidequest: Copy Agent Prompts to prepare prompts for multiple Quests. Sidequest: Toggle Prompt Language switches between Korean, English, and ask-on-copy mode. Sidequest: Set Agent Name changes the default agent name stored for new runs.

Features

• Status-grouped Quest Tree View with open, review, blocked, and done states
• Create, duplicate, delete, open, and reveal Quest files
• Active Quest selection, clearing, and quick opening
• Search by ID, title, Goal, Context, or Label
• Filtering by status, tags, or active Quest
• Quest format validation and diagnostic messages
• Agent Run creation, opening, and deletion
• Korean and English prompt and Agent Run templates
• Automatic refresh when Quest files change
• Git-friendly Markdown storage that remains available after uninstalling the extension

Commands

All features are available from the Command Palette by searching for Sidequest:. Frequently used actions are also available from the Sidequest view title bar and Quest context menu.

Workspace Data

Quest and Agent Run files are plain Markdown. Commit .sidequest/ to Git when you want to share both the work specifications and execution history with your team. Removing the extension does not remove these files.

Installation

To install a VSIX package, open the Extensions view in VS Code, select the ... menu, choose Install from VSIX..., and select the downloaded file. The extension identifier is Sharon77770.sidequest.