Skip to content
Newquantumcoderxyz v2 is now available

Web

Using quantumcoderxyz in your browser.

quantumcoderxyz can run as a web application in your browser, providing the same powerful AI coding experience without needing a terminal.

quantumcoderxyz Web - New Session

Getting Started

Start the web interface by running:

Terminal window
quantumcoderxyz web

This starts a local server on 127.0.0.1 with a random available port and automatically opens quantumcoderxyz in your default browser.


Configuration

You can configure the web server using command line flags or in your config file.

Port

By default, quantumcoderxyz picks an available port. You can specify a port:

Terminal window
quantumcoderxyz web --port 4096

Hostname

By default, the server binds to 127.0.0.1 (localhost only). To make quantumcoderxyz accessible on your network:

Terminal window
quantumcoderxyz web --hostname 0.0.0.0

When using 0.0.0.0, quantumcoderxyz will display both local and network addresses:

Local access: http://localhost:4096
Network access: http://192.168.1.100:4096

mDNS Discovery

Enable mDNS to make your server discoverable on the local network:

Terminal window
quantumcoderxyz web --mdns

This automatically sets the hostname to 0.0.0.0 and advertises the server as quantumcoderxyz.local.

You can customize the mDNS domain name to run multiple instances on the same network:

Terminal window
quantumcoderxyz web --mdns --mdns-domain myproject.local

CORS

To allow additional domains for CORS (useful for custom frontends):

Terminal window
quantumcoderxyz web --cors https://example.com

Authentication

To protect access, set a password using the quantumcoderxyz_SERVER_PASSWORD environment variable:

Terminal window
quantumcoderxyz_SERVER_PASSWORD=secret quantumcoderxyz web

The username defaults to quantumcoderxyz but can be changed with quantumcoderxyz_SERVER_USERNAME.


Using the Web Interface

Once started, the web interface provides access to your quantumcoderxyz sessions.

Sessions

View and manage your sessions from the homepage. You can see active sessions and start new ones.

quantumcoderxyz Web - Active Session

Server Status

Click “See Servers” to view connected servers and their status.

quantumcoderxyz Web - See Servers


Attaching a Terminal

You can attach a terminal TUI to a running web server:

Terminal window
# Start the web server
quantumcoderxyz web --port 4096
# In another terminal, attach the TUI
quantumcoderxyz attach http://localhost:4096

This allows you to use both the web interface and terminal simultaneously, sharing the same sessions and state.


Config File

You can also configure server settings in your quantumcoderxyz.json config file:

{
"server": {
"port": 4096,
"hostname": "0.0.0.0",
"mdns": true,
"cors": ["https://example.com"]
}
}

Command line flags take precedence over config file settings.