AIWinWeb

aiwinweb runs a password-protected local web console for interactive AI CLI, PowerShell, and SSH sessions on Windows. It supports Claude Code, Codex, OpenCode, and Cline as selectable engines; Claude is not required.

Install

py -3.10 -m pip install aiwinweb
aiwinweb init
aiwinweb run

Open http://127.0.0.1:18765 after startup. The first init command asks for the web-console password and writes configuration to ~/.aiwinweb/.env.

Options

# Store configuration and runtime data outside the user profile.
aiwinweb init --home D:\console-data --username admin --port 18765
aiwinweb run --home D:\console-data

# Override only for one process invocation.
aiwinweb run --home D:\console-data --host 127.0.0.1 --port 18765

The installed package is read-only: configuration, passwords, sessions, uploads, logs, and generated keys live in the --home directory instead of site-packages.

Requirements

• Python 3.10 or newer.
• Windows 10 1809+, Windows 11, or Windows Server 2019+ for native Windows terminal support.
• At least one supported CLI installed and authenticated for AI sessions: Claude Code, Codex, OpenCode, or Cline. PowerShell is available on Windows without an AI CLI.

Security

This application can expose an interactive shell and file access. Keep it bound to 127.0.0.1 unless you deliberately configure HTTPS, a restricted ALLOWED_BASE_DIR, firewall rules, a strong password, and TOTP.

Publishing

Publish this package as aiwinweb:

py -m build
py -m twine check dist/*
py -m twine upload dist/*