55 lines
2.3 KiB
Markdown
55 lines
2.3 KiB
Markdown
# Manual Slop
|
|
|
|
Vibe coding.. but more manual
|
|
|
|
|
|
|
|
This tool is designed to work as an auxiliary assistant that natively interacts with your codebase via PowerShell and MCP-like file tools, supporting both Anthropic and Gemini APIs.
|
|
|
|
Features:
|
|
|
|
* Multi-provider support (Anthropic & Gemini).
|
|
* Multi-project workspace management via TOML configuration.
|
|
* Rich discussion history with branching and timestamps.
|
|
* Real-time file context aggregation and summarization.
|
|
* Integrated tool execution:
|
|
* PowerShell scripting for file modifications.
|
|
* MCP-like filesystem tools (read, list, search, summarize).
|
|
* Web search and URL fetching.
|
|
* Extensive UI features:
|
|
* Word-wrap toggles.
|
|
* Popup text viewers for large script/output inspection.
|
|
* Color theming and UI scaling.
|
|
|
|
## Session-Based Logging and Management
|
|
|
|
Manual Slop organizes all communications and tool interactions into session-based directories under `logs/`. This ensures a clean history and easy debugging.
|
|
|
|
* **Organized Storage:** Each session is assigned a unique ID and its own sub-directory containing communication logs (`comms.log`) and metadata.
|
|
* **Log Management Panel:** The GUI includes a dedicated 'Log Management' panel where you can view session history, inspect metadata (message counts, errors, size), and protect important sessions.
|
|
* **Automated Pruning:** To keep the workspace clean, the application automatically prunes insignificant logs. Sessions older than 24 hours that are not "whitelisted" and are smaller than 2KB are automatically deleted.
|
|
* **Whitelisting:** Sessions containing errors, high activity, or significant changes are automatically whitelisted. Users can also manually whitelist sessions via the GUI to prevent them from being pruned.
|
|
|
|
## Documentation
|
|
|
|
* [docs/Readme.md](docs/Readme.md) for the interface and usage guide
|
|
* [docs/guide_tools.md](docs/guide_tools.md) for information on the AI tooling capabilities
|
|
* [docs/guide_architecture.md](docs/guide_architecture.md) for an in-depth breakdown of the codebase architecture
|
|
|
|
## Instructions
|
|
|
|
1. Make a credentials.toml in the immediate directory of your clone:
|
|
|
|
```toml
|
|
[gemini]
|
|
api_key = "****"
|
|
[anthropic]
|
|
api_key = "****"
|
|
```
|
|
|
|
2. Have fun. This is experiemntal slop.
|
|
|
|
```ps1
|
|
uv run .\gui_2.py
|
|
```
|