Metadata-Version: 2.4
Name: aiwinweb
Version: 0.1.0
Summary: A Windows web console for interactive AI CLI, PowerShell, and SSH sessions.
Author: agentself
License-Expression: MIT
Keywords: ai,cli,web,terminal,windows,codex
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: Operating System :: Microsoft :: Windows
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: Flask==3.1.3
Requires-Dist: Flask-SocketIO==5.6.1
Requires-Dist: python-socketio==5.16.3
Requires-Dist: simple-websocket==1.1.0
Requires-Dist: python-dotenv==1.2.2
Requires-Dist: pyotp==2.10.0
Requires-Dist: qrcode==8.2
Requires-Dist: cryptography==49.0.0
Requires-Dist: requests==2.34.2
Requires-Dist: psutil==7.2.2
Requires-Dist: pywinpty==3.0.5; platform_system == "Windows"
Dynamic: license-file

# 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

```powershell
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

```powershell
# 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`:

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