Skip to main content

Wizolt logo: a blue hooded terminal mage holding a lightning staff
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.56.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.56.0
File Size Uploaded
wizolt-0.56.0.tar.gz 510.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for wizolt 0.56.0
File Interpreter ABI Platform
wizolt-0.56.0-py3-none-any.whl Python 3 none any Details

Total release size: 1.1 MB

Release files / wizolt-0.56.0.tar.gz

Download URL wizolt-0.56.0.tar.gz
Size 510.2 kB
Tags Source
SHA-256 checksum
How to use checksums
d13780d7bcc002973377045630d26a8289dd4ad1c01cbb14143603ddcaba0100
BLAKE2b-256 checksum
How to use checksums
e55db3776987d212c7094a96e60dd66dc8d7e5ad1edb6f9f611a737f25ad3faf
Upload date
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.56.0-py3-none-any.whl

Download URL wizolt-0.56.0-py3-none-any.whl
Size 558.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
227ec48cd51cb24d829995779014c80c9446550ef1f145090b1ebba7cfe3a46f
BLAKE2b-256 checksum
How to use checksums
7a90a4e693ca4fdb36e1c4fdc2a6fa2edd91e82c875acfb83cbab4866d7ada80
Upload date
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 history Release notifications | RSS feed

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page