# lil-terminal

> A practical PHP terminal for shared hosting, designed to work from the browser without SSH, Composer or Node.js.

lil-terminal is delivered as a self-extracting `lil.php`, keeps the core compact, installs optional PHP modules into `.lil.php`, supports Base and Minimum packages, ten interface languages, a browser code editor, `.lil` automation and optional floating web-terminal integration.

## Start here

- [Home](https://lil.dog/): Product overview and interactive code demonstration
- [Download](https://lil.dog/download): Build a standalone, JavaScript-integrated or protected PHP-integrated package
- [Industry applications](https://lil.dog/download/industry): 88 curated starting configurations for real-world PHP hosting maintenance; detailed pages explain typical tasks, recommended modules and ready-to-download builds
- [Documentation](https://lil.dog/docs): Command reference and practical guides by task
- [FAQ](https://lil.dog/faq): Installation, security, modules, web integration and troubleshooting
- [News](https://lil.dog/news): Product news and notable changes
- [Web-terminal integration](https://lil.dog/web-terminal): JavaScript and protected PHP setup
- [Customization](https://lil.dog/customization): Composable interface packages, storage modes and optional browser features
- [Core versions](https://lil.dog/versions): Core release history
- [Pricing](https://lil.dog/pricing): Free personal use and commercial deployment pricing
- [License](https://lil.dog/license): Personal, organizational and commercial-use policy
- [Commercial evaluation](https://lil.dog/trial): 40-day evaluation terms for organizations and paid work
- [Order a license](https://lil.dog/buy): Secure invoice-request form for commercial deployments
- [Support](https://lil.dog/support): Voluntary project support and donation options
- [Technical support](https://lil.dog/contact): Send a reproducible problem report or question
- [Privacy](https://lil.dog/privacy): Analytics consent, essential storage and data-handling controls

## Important product facts

- Maintained runtime: PHP 8; frozen PHP 7.4 compatibility build available.
- Core generation: 1.
- Core generation 1 is free without a time limit for personal noncommercial use. Organizations and commercial work require one license per active production deployment after a 40-day evaluation.
- Commercial licenses are perpetual for core generation 1, include updates within that generation and do not use DRM or remote activation.
- Commands execute through PHP APIs; lil-terminal is not a Bash emulator and does not depend on `exec()`.
- Repository API: `repo.lil.dog`; technical headers are routing discriminators, not authentication.
- Authorization is physically included or removed at build time.
- Public documentation examples use a fixed sandbox; the website never executes terminal commands.
- Core 1.5.13 is the current production release in generation 1. The current command surface includes the active-file `$` token, extension-aware file opening, linear `.lil` scripts, structured Base output and browser file upload.
- Current value-taking commands use `:` for values while `>` is reserved for output redirection; interface packages are managed explicitly through `include`.

## Command groups

- [Files](https://lil.dog/docs/files): Manage project files and directories from the browser: inspect, create, search, copy, move, rename, edit and upload.
- [Development](https://lil.dog/docs/development): Edit and review source files on the server with code views, diffs, text replacement, patches and PHP checks.
- [Archives](https://lil.dog/docs/archives): Create, inspect, test and extract ZIP, TAR and GZIP archives directly on the hosting account.
- [Data](https://lil.dog/docs/data): Read and modify configuration formats, JSON, image metadata and calculated values directly on the server.
- [Database](https://lil.dog/docs/database): Work with MySQL/MariaDB, PostgreSQL, Redis, SQLite and MongoDB from lil-terminal.
- [Network](https://lil.dog/docs/network): Check DNS, HTTP, TCP, IP information, mail connectivity and remote services from the hosting environment.
- [Diagnostics](https://lil.dog/docs/diagnostics): Inspect PHP, environment variables, logs, sessions, disk space and server runtime information.
- [Security](https://lil.dog/docs/security): Handle authorization, certificates, encryption, hashes and cryptographically secure random values.
- [Automation](https://lil.dog/docs/automation): Turn repeatable terminal work into .lil scripts that use the same commands as interactive terminal sessions.
- [System](https://lil.dog/docs/system): Manage lil-terminal itself: help, history, interface packages, modules, updates and removal.

Each group page provides a `setup.lil` file for installing the current versions of its installable commands.

## Complete machine-readable reference

- [Full project and command index](https://lil.dog/llms-full.txt)

About the project: https://lil.dog/about

Official download safety: https://lil.dog/faq/official-download