60 lines
3.7 KiB
Markdown
60 lines
3.7 KiB
Markdown
# 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 <project>.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 <project>_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.
|