Files
manual_slop/docs

Manual Slop

A GUI orchestrator for local LLM-driven coding sessions, built to prevent the AI from running wild and to provide total transparency into the context and execution state.

Core Management Panels

Projects Panel

The heart of context management.

Note: The Config panel has been removed. Output directory and auto-add history settings are now integrated into the Projects and Discussion History panels respectively.

  • Configuration: You specify the Git Directory (for commit tracking) and a Main Context File (the markdown file containing your project's notes and schema).
  • Word-Wrap Toggle: Dynamically swaps text rendering in large read-only panels (Responses, Comms Log) between unwrapped (ideal for viewing precise code formatting) and wrapped (ideal for prose).
  • Project Switching: Switch between different .toml profiles to instantly swap out your entire active file list, discussion history, and settings.

Discussion History

Manages your conversational branches, preventing context poisoning across different tasks.

  • Discussions Sub-Menu: Allows you to create separate timelines for different tasks (e.g., "Refactoring Auth" vs. "Adding API Endpoints").
  • Git Commit Tracking: Clicking "Update Commit" reads HEAD from your project's git directory and stamps the discussion.
  • Entry Management: Each turn has a Role (User, AI, System). You can toggle entries between Read and Edit modes, collapse them, or hit [+ Max] to open them in the Global Text Viewer.
  • Auto-Add: If toggled, anything sent from the "Message" panel and returned to the "Response" panel is automatically appended to the current discussion history.

Files & Screenshots

Controls what is explicitly fed into the context compiler.

  • Base Dir: Defines the root for path resolution and tool constraints.
  • Paths: Explicit files or wildcard globs (e.g., src/**/*.rs).
  • When generating a request, full file contents are inlined into the context by default (summary_only=False). The AI can also call get_file_summary via its MCP tools to get a compact structural view of any file on demand.

Interaction Panels

Provider

Switch between API backends (Gemini, Anthropic) on the fly. Clicking "Fetch Models" queries the active provider for the latest model list.

Message & Response

  • Message: Your input field.
  • Gen + Send: Compiles the markdown context and dispatches the background thread to the AI.
  • MD Only: Dry-runs the compiler so you can inspect the generated _00N.md without triggering an API charge.
  • Response: The read-only output. Flashes green when a new response arrives.

Global Text Viewer & Script Outputs

  • Last Script Output: Whenever the AI executes a background script, this window pops up, flashing blue. It contains both the executed script and the stdout/stderr. The [+ Maximize] buttons read directly from stored instance variables (_last_script, _last_output) rather than DPG widget tags, so they work correctly regardless of word-wrap state.
  • Text Viewer: A large, resizable global popup invoked anytime you click a [+] or [+ Maximize] button in the UI. Used for deep-reading long logs, discussion entries, or script bodies.
  • Confirm Dialog: The [+ Maximize] button in the script approval modal passes the script text directly as user_data at button-creation time, so it remains safe to click even after the dialog has been dismissed.

System Prompts

Provides two text inputs for overriding default instructions:

  1. Global: Applied across every project you load.
  2. Project: Specific to the active workspace. These are concatenated onto the strict tool-usage guidelines the agent is initialized with.