# Vis

> Vis is a coding agent you can adapt to your tools and workflow.

## Documentation

- [Getting started](https://vis.blockether.com/index.md): Install Vis, connect the desktop or phone app and try your first task with a model you choose.
- [Why I built Vis](https://vis.blockether.com/motivation.md): Why I chose reusable tools over more reminders, Python to connect the steps and a shared view across devices.
- [Configuration](https://vis.blockether.com/configuration.md): Choose providers and models, and save settings for yourself, a project or every gateway client.
- [Project instructions](https://vis.blockether.com/context-and-prompts.md): Tell Vis how your project works, write reusable prompts and set a goal for a longer task.
- [Skills](https://vis.blockether.com/skills.md): Give Vis reusable instructions for reviews, releases and other tasks, with scripts and templates.
- [Controlling a session](https://vis.blockether.com/queue-and-cancel.md): Send follow-up messages while Vis works, edit queued requests, cancel a task or quit the session.
- [Council](https://vis.blockether.com/council.md): Ask another session for help, get a second review or share findings without repeating research.
- [Exporting sessions](https://vis.blockether.com/exporting-sessions.md): Save a conversation as Markdown or a self-contained HTML page, and check it before sharing.
- [Drafts](https://vis.blockether.com/drafts.md): Try a change in an isolated working copy, review the diff and decide whether to approve it.
- [Reporting a bug](https://vis.blockether.com/reporting-bugs.md): Report a problem with useful evidence, without sharing credentials or private code.
- [Python SDK](https://vis.blockether.com/python-sdk.md): Run a task in your project with Agent, continue the conversation or connect to a shared Vis gateway.
- [Java and Clojure SDK](https://vis.blockether.com/jvm-sdk.md): Connect Java or Clojure to a Vis gateway, submit tasks and handle results without rebuilding the engine.
- [Running a gateway](https://vis.blockether.com/gateway-service.md): Install and secure a shared Vis gateway, connect your clients and keep it running as a Linux service.
- [Extending Vis](https://vis.blockether.com/extending.md): Write a Python tool, register it with Vis and try it in a session, starting with one file.
- [Extension design](https://vis.blockether.com/extension-design.md): Choose useful operations, explain their inputs and results, and test both Python code and Vis integration.
- [Installing and sharing extensions](https://vis.blockether.com/extension-packages.md): Install an extension for one project or all your projects, reload edits or package it to share.
- [Using an existing Python project](https://vis.blockether.com/extension-development.md): Connect an existing uv project to Vis while keeping its implementation editable in your checkout.
- [Native builds for Java and Clojure extensions](https://vis.blockether.com/jvm-native-image.md): Add Java or Clojure capabilities inside Vis, then build, test and package a native engine containing your code.
- [Extension API](https://vis.blockether.com/extension-api.md): Look up Python declarations, callbacks, tool contracts and host operations for Vis extensions.
- [Extension troubleshooting](https://vis.blockether.com/extension-troubleshooting.md): Find out why your extension will not load, a tool is missing or old code still runs after an edit.
- [Forms and user input](https://vis.blockether.com/human-input.md): Build a form that asks for a choice, credential or confirmation, and handle the answer.
- [Live views](https://vis.blockether.com/live-views.md): Show progress and controls while an extension watches a build or other ongoing work.
- [Provider extensions](https://vis.blockether.com/provider-extensions.md): Connect an LLM service to Vis with custom sign-in, model discovery and credential management.
- [How Vis manages context](https://vis.blockether.com/token-optimization.md): See how Vis filters tool output, reuses findings and summarizes long conversations to manage context.
- [Python sandbox](https://vis.blockether.com/python-sandbox.md): Understand where the agent runs Python, which packages it uses and what it can access.
- [Process jail and network policy](https://vis.blockether.com/jail.md): Limit file access, environment variables and network connections for commands Vis runs.
- [Runtime distributions](https://vis.blockether.com/distributions.md): Install or update Vis, choose a release track and compare native releases with JVM source builds.
- [Logs and diagnostics](https://vis.blockether.com/logging.md): Find diagnostic logs, command output and hang reports, understand retention and review files before sharing.

## Python SDK API reference

- [blockether.vis](https://vis.blockether.com/python-sdk-api/blockether/vis.html): Generated development API reference.
- [blockether.vis.activity](https://vis.blockether.com/python-sdk-api/blockether/vis/activity.html): Generated development API reference.
- [blockether.vis.engine](https://vis.blockether.com/python-sdk-api/blockether/vis/engine.html): Generated development API reference.
- [blockether.vis.extension](https://vis.blockether.com/python-sdk-api/blockether/vis/extension.html): Generated development API reference.
- [blockether.vis.extension_package](https://vis.blockether.com/python-sdk-api/blockether/vis/extension_package.html): Generated development API reference.
- [blockether.vis.views](https://vis.blockether.com/python-sdk-api/blockether/vis/views.html): Generated development API reference.

## Extension Center

- [Public extensions](https://vis.blockether.com/extensions/llms.txt): Live catalog index.
- [Catalog API](https://vis.blockether.com/api/extensions): Approved listings as JSON.

## Optional

- [Full documentation](https://vis.blockether.com/llms-full.txt)