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

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.62.0
File	Size	Uploaded
wizolt-0.62.0.tar.gz	551.2 kB	Sep 30, 2026	Details

Built distribution (wheel)

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

Total release size: 1.2 MB

Release files / wizolt-0.62.0.tar.gz

Download URL	wizolt-0.62.0.tar.gz
Size	551.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`2b7c3be75188c12e08ca10934270e59b2ba50f547408c41bbd56e290f9c22b60`
BLAKE2b-256 checksum How to use checksums	`7037f77994a929845a3e0984282511a1804b4c76c0b2c4773409a8cdd55dda0b`
Upload date	Sep 30, 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.62.0-py3-none-any.whl

Download URL	wizolt-0.62.0-py3-none-any.whl
Size	602.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`0218b209d13ff2282813dac76a5554eb7ab5add65054041a54b80a0dc8d2be54`
BLAKE2b-256 checksum How to use checksums	`16840963f2557a743e43eb2c7e36683af5ef322458d36da954224fe11e307e46`
Upload date	Sep 30, 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}`