← Back to Skills Marketplace
267
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install http-static-server
Description
Start a local HTTP static file server in the current or specified directory using one-line commands compatible with 25+ languages and tools, auto-detecting r...
README (SKILL.md)
HTTP Static Server One-Liners
Start an ad-hoc HTTP static file server serving the current (or specified) directory.
Default: http://localhost:8000
Reference: \x3Chttps://gist.github.com/willurd/5720255>
Detailed per-language docs: {baseDir}/references/
When to use this skill
- User needs to quickly serve static files (HTML/CSS/JS/images) locally
- User asks "how do I start a local web server" or similar
- User wants to preview a static site, share files over LAN, or test frontend assets
- User needs a quick HTTP server for development or testing
Quick Reference Table
| Language/Tool | Command | Dir Listing | Install Needed |
|---|---|---|---|
| Python 3 | python3 -m http.server 8000 |
Yes | No |
| Python 2 | python -m SimpleHTTPServer 8000 |
Yes | No |
| Twisted | twistd -n web -p 8000 --path . |
Yes | pip install twisted |
| Node.js (npx) | npx http-server -p 8000 |
Yes | No |
| Node.js (serve) | npx serve -l 8000 |
Yes | No |
| node-static | npx node-static -p 8000 |
No | No |
| Deno | deno run --allow-net --allow-read jsr:@std/http/file-server |
Yes | No |
| PHP | php -S 127.0.0.1:8000 |
No | No |
| Ruby | ruby -run -ehttpd . -p8000 |
Yes | No |
| Ruby (WEBrick) | ruby -rwebrick -e'WEBrick::HTTPServer.new(:Port=>8000,:DocumentRoot=>Dir.pwd).start' |
Yes | No |
| Ruby (adsf) | adsf -p 8000 |
No | gem install adsf |
| Ruby (Sinatra) | ruby -rsinatra -e'set :public_folder,".";set :port,8000' |
No | gem install sinatra |
| Go | go run github.com/goware/webify@latest -port 8000 . |
Yes | No |
| Java 18+ | jwebserver -d . -b 0.0.0.0 -p 8000 |
Yes | No |
| Java (module) | java -m jdk.httpserver -d . -b 0.0.0.0 -p 8000 |
Yes | No |
| Rust | miniserve -p 8000 . |
Yes | cargo install miniserve |
| Perl (Plack) | plackup -MPlack::App::Directory -e 'Plack::App::Directory->new(root=>".");' -p 8000 |
Yes | cpan Plack |
| Perl (Brick) | perl -MHTTP::Server::Brick -e '$s=HTTP::Server::Brick->new(port=>8000);$s->mount("/"=>{path=>"."});$s->start' |
Yes | cpan HTTP::Server::Brick |
| Perl (Mojo) | perl -MMojolicious::Lite -MCwd -e 'app->static->paths->[0]=getcwd;app->start' daemon -l http://*:8000 |
No | cpan Mojolicious::Lite |
| Erlang | erl -s inets -eval 'inets:start(httpd,[...]).' |
No | No |
| Elixir | elixir --no-halt -e 'Application.start(:inets);:inets.start(:httpd,...)' |
No | No |
| BusyBox | busybox httpd -f -p 8000 |
Yes | No |
| lighttpd | lighttpd -Df - \x3C\x3C\x3C ... |
Configurable | brew install lighttpd |
| webfs | webfsd -F -p 8000 |
Yes | apt install webfs |
| Algernon | algernon -x . :8000 |
Yes | brew install algernon |
| Docker (Nginx) | docker run --rm -v "$PWD":/usr/share/nginx/html:ro -p 8000:80 nginx |
Configurable | Docker |
| Docker (PHP) | docker run -it --rm -v "$PWD":/app -w /app -p 8000:8000 php:8.2-cli php -S 0.0.0.0:8000 |
No | Docker |
| PowerShell (Pode) | Start-PodeStaticServer -Port 8000 -FileBrowser -Address 0.0.0.0 |
Yes | Install-Module Pode |
| IIS Express | iisexpress.exe /path:C:\MyWeb /port:8000 |
No | Windows |
Decision guide for the agent
- Detect runtimes: Check which runtimes are available (
python3 --version,node --version,deno --version, etc.). - Default to Python 3 — pre-installed on most Linux/macOS systems.
- Node.js project context — prefer
npx serveornpx http-server. - Deno project context — use the
jsr:@std/http/file-server. - Minimal environment (containers, embedded) — use
busybox httpd. - Windows without WSL — use PowerShell (Pode) or IIS Express.
- Need features (upload, auth, HTTPS) — recommend
miniserve(Rust) or Algernon. - No runtime available — suggest Docker approach.
- Always confirm the desired port (default 8000) and directory (default
.). - For per-language details, flags, and advanced usage, see
{baseDir}/references/\x3Clanguage>.md.
Common options
| Need | Solution |
|---|---|
| Custom port | Replace 8000 with desired port in any command |
| Serve a specific directory | Append the path or use the tool's directory flag |
| Bind to all interfaces (LAN) | Use 0.0.0.0 as the bind address |
| CORS headers | npx http-server --cors or add middleware |
| HTTPS | miniserve --tls-cert/--tls-key, reverse proxy, or openssl s_server |
| Directory listings | Python, http-server, Plack, miniserve, BusyBox support by default |
| File upload | miniserve --upload-files |
| Authentication | miniserve --auth user:password |
| Docker (no local runtime) | See {baseDir}/references/docker.md |
Per-language reference docs
Detailed documentation with full flags, install instructions, and advanced usage:
{baseDir}/references/python.md— Python 3, Python 2, Twisted{baseDir}/references/nodejs.md— http-server, serve, node-static, inline{baseDir}/references/deno.md— std/http file-server{baseDir}/references/php.md— Built-in dev server, Docker{baseDir}/references/ruby.md— ruby -run, WEBrick, adsf, Sinatra{baseDir}/references/go.md— webify, inline Go{baseDir}/references/rust.md— miniserve, http{baseDir}/references/java.md— jwebserver, jdk.httpserver, inline{baseDir}/references/perl.md— Plack, HTTP::Server::Brick, Mojolicious{baseDir}/references/erlang.md— inets{baseDir}/references/elixir.md— :inets, Plug{baseDir}/references/busybox.md— busybox httpd{baseDir}/references/docker.md— Nginx, PHP, Python, Alpine{baseDir}/references/powershell.md— Pode, .NET HttpListener, IIS Express{baseDir}/references/lighttpd.md— inline config, config file{baseDir}/references/webfs.md— webfsd{baseDir}/references/algernon.md— static mode, Lua scripting
Usage Guidance
This skill is an instruction-only guide for starting local static servers and appears internally consistent. Before running any suggested command, confirm the port and directory. Be aware that several recommended one-liners will fetch or execute code from remote package registries or start containers (e.g., npx, go run, deno run, pip/cargo installs, docker run) — only run those if you trust the upstream packages. Also note bind addresses like 0.0.0.0 expose the server to your LAN; use 127.0.0.1 or bind to a specific IP if you only want local access. Prefer read-only Docker mounts when sharing files into containers and inspect any unfamiliar commands before executing.
Capability Analysis
Type: OpenClaw Skill
Name: http-static-server
Version: 2026.3.10
The skill bundle is a legitimate utility designed to help an AI agent start local HTTP static file servers using standard one-line commands across various environments (Python, Node.js, Docker, etc.). The commands provided in SKILL.md and the references/ directory are well-known, industry-standard methods for ad-hoc file serving and match the stated purpose of the skill. No evidence of malicious intent, data exfiltration, or harmful prompt injection was found.
Capability Assessment
Purpose & Capability
The name/description (one-line HTTP static server) matches the content: SKILL.md and references provide one-liner commands across many runtimes. No unrelated credentials, binaries, or install steps are requested.
Instruction Scope
The runtime instructions are focused on detecting available runtimes, choosing an option (default Python 3), and returning an exact one-liner. They do recommend commands that change networking exposure (binding to 0.0.0.0) and use package managers/remote registries (npx, go run, deno run, pip, cargo, etc.) and Docker mounts; these are expected for the task but are worth calling out because they can fetch/execute remote code or expose files to containers or the LAN.
Install Mechanism
Instruction-only skill with no install spec and no code files. The skill itself does not write or install anything. It does suggest developer tooling commands that, when executed by a user/agent, may install or run packages from registries — that is appropriate for this utility but not performed by the skill itself.
Credentials
The skill requests no environment variables or credentials. It only asks the agent to detect available runtimes (e.g., `python3 --version`) and confirm port/directory, which is proportionate to its purpose.
Persistence & Privilege
always is false and there are no install hooks or modifications to other skills or system config. Autonomous invocation is allowed (default) but this is normal for skills; no elevated persistence is requested.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install http-static-server - After installation, invoke the skill by name or use
/http-static-server - Provide required inputs per the skill's parameter spec and get structured output
Version History
v2026.3.10
- Initial release of http-static-server skill.
- Instantly start a local HTTP static file server in the current directory with one-line commands for 25+ languages and tools.
- Auto-detects installed runtimes and recommends the best option (Python, Node, Deno, PHP, Go, Rust, etc.).
- Includes a detailed quick reference table, decision guide, and common options (custom port, CORS, HTTPS, upload/auth).
- Links to per-language reference docs for usage details, install instructions, and advanced features.
Metadata
Frequently Asked Questions
What is one line HTTP static server?
Start a local HTTP static file server in the current or specified directory using one-line commands compatible with 25+ languages and tools, auto-detecting r... It is an AI Agent Skill for Claude Code / OpenClaw, with 267 downloads so far.
How do I install one line HTTP static server?
Run "/install http-static-server" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is one line HTTP static server free?
Yes, one line HTTP static server is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does one line HTTP static server support?
one line HTTP static server is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created one line HTTP static server?
It is built and maintained by 浮生 (@flowerwrong); the current version is v2026.3.10.
More Skills