Skip to main content

Web interface

Overview

The faheemcode web command launches the CLI's terminal interface as a web application, accessible through your browser. This is useful when you want to:

  • Access the CLI remotely
  • Share your terminal session
  • Use the CLI on devices without a full terminal
faheemcode web

Basic usage

# Start on default port (12000)
faheemcode web

# Access at http://localhost:12000

Options

OptionDefaultDescription
--host0.0.0.0Host address to bind to
--port12000Port number to use
--debugfalseEnable debug mode

Examples

# Custom port
faheemcode web --port 8080

# Bind to localhost only (more secure)
faheemcode web --host 127.0.0.1

# Enable debug mode
faheemcode web --debug

# Full example with custom host and port
faheemcode web --host 0.0.0.0 --port 3000

Remote access

To access the web interface from another machine:

  1. Start with --host 0.0.0.0 to bind to all interfaces:

    faheemcode web --host 0.0.0.0 --port 12000
  2. Access from another machine using the host's IP:

    http://<host-ip>:12000

Use cases

Development on remote servers

Access Faheem Code on a remote development server through your local browser:

# On remote server
faheemcode web --host 0.0.0.0 --port 12000

# On local machine, use SSH tunnel
ssh -L 12000:localhost:12000 user@remote-server

# Access at http://localhost:12000

Sharing sessions

Run the web interface on a shared server for team access:

faheemcode web --host 0.0.0.0 --port 8080

Comparison: web interface vs GUI server

Featurefaheemcode webfaheemcode serve
InterfaceTerminal UI in browserFull web GUI
DependenciesNoneDocker required
ResourcesLightweightFull container
Best forQuick accessRich GUI experience

See also