feat: add sitrep-panel skill
Live local HTML progress report (status board, running narrative, screenshots, newest-first log) served on localhost via a stdlib-only Python server, so a human can watch a long/delegated agent task without reading the raw transcript. Adapted from dbl8005/sitrep-panel (MIT), evaluated and drafted via Codex per this fleet's standard skill-candidate review process. Bundled server and HTML template copied unmodified from upstream. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
Executable
+49
@@ -0,0 +1,49 @@
|
||||
#!/usr/bin/env python3
|
||||
"""Serve a sitrep-panel report directory on a free localhost port.
|
||||
|
||||
Usage: python3 serve.py <directory> [preferred_port]
|
||||
|
||||
Prints exactly one line to stdout on success: `SERVING http://localhost:<port>/`
|
||||
then blocks, running the HTTP server — launch this with the caller's
|
||||
background/detached mechanism (e.g. Claude Code's Bash tool with
|
||||
run_in_background: true). Stdlib only, no dependencies.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import functools
|
||||
import http.server
|
||||
import sys
|
||||
|
||||
|
||||
class QuietHandler(http.server.SimpleHTTPRequestHandler):
|
||||
"""SimpleHTTPRequestHandler that suppresses per-request access logging,
|
||||
so stdout stays to the one clean SERVING line callers parse."""
|
||||
|
||||
def log_message(self, format: str, *args: object) -> None: # noqa: A002
|
||||
pass
|
||||
|
||||
|
||||
def main() -> None:
|
||||
if len(sys.argv) < 2:
|
||||
print("usage: serve.py <directory> [preferred_port]", file=sys.stderr)
|
||||
sys.exit(1)
|
||||
|
||||
directory = sys.argv[1]
|
||||
preferred_port = int(sys.argv[2]) if len(sys.argv) > 2 else 8934
|
||||
handler = functools.partial(QuietHandler, directory=directory)
|
||||
|
||||
try:
|
||||
httpd = http.server.ThreadingHTTPServer(("127.0.0.1", preferred_port), handler)
|
||||
except OSError:
|
||||
# Preferred port is taken — let the OS assign a free one rather than
|
||||
# guessing and racing another process for it.
|
||||
httpd = http.server.ThreadingHTTPServer(("127.0.0.1", 0), handler)
|
||||
|
||||
port = httpd.server_address[1]
|
||||
print(f"SERVING http://localhost:{port}/", flush=True)
|
||||
httpd.serve_forever()
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
main()
|
||||
Reference in New Issue
Block a user