Repoburg
Login

Core Workflows

This section covers the primary workflows you'll use within the Repoburg application, from managing sessions to interacting with the AI's plans and using shortcuts.

Session Management

A "session" in Repoburg is a complete conversation with the AI, including all your prompts and the AI's generated plans.

Starting a New Session

Click the New Session button in the Session Panel. A new, empty session will be created, inheriting the default system prompt and context templates.

Creating a Follow-up Session

When you have an existing session loaded, you can click the Follow-up button. This creates a new session with an initial context derived from the previous one. Specifically, it gathers all files that were created, edited, or explicitly mentioned in the previous session and adds them as ad-hoc context to the new session's first prompt. This is a powerful way to continue a complex task without losing context.

Session History

The Session History page (accessible from the home dashboard) lists all of your previous sessions.

  • Loading a Session: Simply click on a session title to load it into the active view. Its full conversation history and the final state of its plan will be displayed.
  • Filtering: You can choose to hide empty sessions (sessions where no prompts were ever sent).
  • Sorting: You can sort sessions by date, either newest or oldest first.

Import / Export

You can easily back up or share your sessions.

  • Export: From the Session History page, use the action menu (...) for any session and select Export. This will download a .json file containing the entire session, including all prompts, AI responses, and related entities like the templates that were used.
  • Import: Click the Import Session(s) button on the Session History page. You can select a previously exported .json file to import it into your database. The import process will skip any entities (sessions, templates, etc.) that already exist with the same ID, so it's safe to re-import a file.

Execution Strategies & Plan Interaction

You can choose an execution strategy for each prompt you send. This determines how AI-generated actions are handled and how you interact with them in the Plan Interaction view.

Review First

This is the safest workflow.

  1. The AI proposes a plan of actions (create, edit, delete files, etc.).
  2. No changes are made to your file system yet.
  3. You review each proposed action. You must explicitly Accept Change for each action you agree with. You can also Discard Change.
  4. Once you've reviewed the plan, you click the global Apply Approved Changes button to execute only the actions you accepted.

Apply & Revert

This is a faster, more iterative workflow.

  1. The AI generates a plan of actions.
  2. The actions are immediately applied to your file system. The original content of any modified or deleted files is saved in memory.
  3. You review the changes. The status of each action is "applied_pending_review".
  4. For each action, you can either Keep Change (confirming it) or Revert Change (which undoes the modification).
  5. You can also use the global Confirm All or Revert All buttons.

The AI Action Block

Each action is displayed in its own collapsible block showing its type, target, status, and order. Expanding it reveals details like a code diff or command string, along with the action controls (Accept, Discard, Keep, Revert).

Execution Logs

After an action is executed (either applied or reverted), logs of the operation will appear in a summary at the bottom of the page and within the individual action blocks. This helps you confirm what happened and diagnose any errors.

Codebase Exploration & request_context

A powerful feature of Repoburg is its ability to interact with AI models that can ask for more information when they don't have enough context. This is handled through a special request_context action.

The Exploration Loop

When the AI determines it needs more files or folders to fulfill your request, it will respond with a request_context action instead of a plan to modify files. How Repoburg handles this depends on your settings.

Automated Mode (Default)

  • By default, Auto Context Fetch is enabled in the Workflow Settings.
  • When Repoburg receives a request_context action, it automatically:
    1. Validates that the requested files and folders exist.
    2. Adds them to the ad-hoc context.
    3. Re-runs your original prompt using your default follow-up template, now including the new context.
    4. Sends the newly generated, richer prompt to your external AI tool via WebSocket. The "AI Studio PowerTools" userscript will automatically paste this new prompt for you.
  • This creates a seamless, conversational loop where the AI explores the codebase with minimal manual intervention from you.

Manual Mode

  • If you disable Auto Context Fetch, the loop becomes manual.
  • When Repoburg receives a request_context action, it will:
    1. Display the action in the Plan Interaction view.
    2. Show you which files and folders the AI requested, and why.
    3. Automatically add the requested items to the ad-hoc context for your next prompt.
  • You can then review the requested items, add or remove context as you see fit, and re-submit your prompt when you are ready. This gives you full control over the exploration process.

Manual LLM Mode

This mode allows you to use any external AI model (like a private Llama instance, Claude, or a specific version of Gemini/GPT).

  1. Enable "Manual LLM" from the toggle in the Session Panel.
  2. Write your prompt and click Prepare. This generates the full context string.
  3. Copy the prepared context and paste it into your external LLM.
  4. Copy the raw response from the LLM.
  5. Paste it into the "Paste LLM Raw Response" box in the Repoburg UI and click Submit LLM Output.
  6. Repoburg will then parse the response and display the plan, following the "Review First" or "Apply & Revert" strategy you selected.

Shortcuts & Command Palette

Command Palette

Press Cmd/Ctrl + Shift + P anywhere in the application to open the Command Palette. This gives you quick, searchable access to almost every action, including:

  • Navigating to different pages.
  • Creating or editing templates, prompts, and snippets.
  • Loading recent sessions.

Keyboard Shortcuts

  • Cmd/Ctrl + Shift + P: Open Command Palette.
  • Cmd/Ctrl + Shift + V: Paste raw LLM output from clipboard to the active session.
  • Alt + R: Reload the active session from the backend.
  • Alt + Shift + N: Start a new session.
  • Cmd/Ctrl + Enter: (In prompt input boxes) Send the prompt or prepare the manual LLM input.
  • Cmd + B: Toggle the main sidebar (in supported views).