Files
manual_slop/docs/Readme.md
2026-02-22 09:20:02 -05:00

3.1 KiB

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.

  • 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, these files are summarized symbolically (summarize.py) to conserve tokens, unless the AI explicitly decides to read their full contents via its internal tools.

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.
  • 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.

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.