# Manual Slop

Vibe coding.. but more manual

![img](./gallery/python_2026-02-21_23-37-29.png)

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
```
