wizolt

wizolt working through a long session with background jobs, an edit preview, and a live status bar

A terminal coding agent I use, maintain, and customize, shipped as a self-contained Python package.

Safety

Use at your own risk. wizolt can edit files and run shell commands in the environment where it starts. It does not provide sandbox isolation; use a container or VM when needed.

What it is

wizolt does not introduce a new kind of coding agent. It combines familiar features — reading and editing files, running commands, follow-ups, sessions, diffs, MCP, and skills — into a tool I use personally.

It works on real repositories, including its own: I use wizolt to build and maintain wizolt. Everything ships in one self-contained Python package, so I can change the behavior directly whenever I want the workflow to work differently.

Wizolt is the former minacode, which began as the single-file nanocode. The implementation outgrew both earlier names; the project history remains continuous.

wizolt resuming a saved session

_{Resuming a saved session with its conversation and tool history.}

Highlights

Prompt caching: stable request prefixes help supported providers reuse earlier work, including during compaction. Check reported cache usage with /status.
Continuity for long tasks: automatic compaction carries working notes and recent tool activity forward, with older details available for recall. Resume saved conversation, tool history, and diffs with -c or --resume.
Precise edits: target a numbered source view or an exact, unique text match. Stale or ambiguous targets are rejected before the edit is applied.
Review changes in place: /diff shows both the latest round's changes and the net result of the session, without leaving the terminal.
Steer work as it happens: send a follow-up with Enter, hold a separate task with Tab, or interrupt with Ctrl-C once the draft is empty.
Background commands: let long-running commands continue as jobs, inspect their output, and wait for or stop them when needed.
Worker delegation: give a bounded task to a worker with its own provider and reusable context. Configure it with /worker; the agent delegates through Delegate.
Choose your provider: use OpenAI-compatible Chat Completions or Responses APIs, or Anthropic Messages. Optional provider-side web search shows searches and sources in the transcript.
MCP and skills: connect external tools through MCP and load reusable Markdown instructions on demand.

Install

Requires macOS or Linux, Python 3.11+, and uv.

uv tool install wizolt
wizolt --init-config

Add your provider to ~/.wizolt/config.toml:

[provider]
active = "default"

[provider.default]
url = "https://api.deepseek.com"
key = "sk-..."
model = "deepseek-flash"

Then run:

wizolt

Upgrade with uv tool upgrade wizolt.

Metadata

Release files for wizolt 0.57.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for wizolt 0.57.2
File	Size	Uploaded
wizolt-0.57.2.tar.gz	522.6 kB	Sep 29, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for wizolt 0.57.2
File	Interpreter	ABI	Platform	Reset
wizolt-0.57.2-py3-none-any.whl 571.2 kB Sep 29, 2026	Python 3	none	any	Details

Total release size: 1.1 MB

Release files / wizolt-0.57.2.tar.gz

Download URL	wizolt-0.57.2.tar.gz
Size	522.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`978c39985271d9e6098c62529a635288a5881d1a87d6b41583592f6696815326`
BLAKE2b-256 checksum How to use checksums	`2eaf950be8177d6a18f2adf9500aaef0d8e4f33f493cc68896910d6b6b02bd73`
Upload date	Sep 29, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}`

Release files / wizolt-0.57.2-py3-none-any.whl

Download URL	wizolt-0.57.2-py3-none-any.whl
Size	571.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`40b54914de7f69b2a62e1d67849d5a63d933aa224deea7bef3f145696c20369b`
BLAKE2b-256 checksum How to use checksums	`3cba8889d99f1b1b3f3c0f077098f33ccfc8f00fe5b3271c5a1854952f2bbb99`
Upload date	Sep 29, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`uv/0.12.17 {"installer":{"name":"uv","version":"0.12.17","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}`