Function status

metaclaw/cli.py:359–433

Check whether MetaClaw is running.

(config: str | None, port: int | None)

)
@click.option("--port", type=int, default=None, help="Proxy port of the instance to query.")
def status(config: str | None, port: int | None):
    """Check whether MetaClaw is running."""
    import os
    from pathlib import Path
    from .launcher import pid_file_for_port

    if config:
        cs = ConfigStore(config_file=Path(config))
    else:
        cs = ConfigStore()
    if port is None:
        port = cs.get("proxy.port") or 30000

    pid_file = pid_file_for_port(port)
    if not pid_file.exists():
        click.echo(f"MetaClaw: not running (port {port})")
        return

    try:
        pid = int(pid_file.read_text().strip())
        os.kill(pid, 0)  # check if process exists
    except (ProcessLookupError, ValueError):
        click.echo("MetaClaw: not running (stale PID file)")
        pid_file.unlink(missing_ok=True)
        return
    try:
        import urllib.request
        with urllib.request.urlopen(
            f"http://localhost:{port}/healthz", timeout=2
        ) as resp:
            healthy = resp.status == 200
    except Exception:
        healthy = False

    mode = cs.get("mode") or "?"
    if healthy:
        click.echo(f"MetaClaw: running  (PID={pid}, mode={mode}, proxy=:{port})")
    else:
        click.echo(f"MetaClaw: starting (PID={pid}, mode={mode}, proxy=:{port})")

    cfg = cs.to_metaclaw_config()
    if cfg.memory_enabled:
        from pathlib import Path as _P
        import json as _json

        policy_path = _P(cfg.memory_policy_path).expanduser()
        if policy_path.exists():
            try:
                policy = _json.loads(policy_path.read_text())
                click.echo(
                    "memory:     "
                    f"mode={policy.get('retrieval_mode', '?')}  "
                    f"units={policy.get('max_injected_units', '?')}  "
                    f"tokens={policy.get('max_injected_tokens', '?')}"
                )
            except Exception:
                click.echo(f"memory:     policy file unreadable ({policy_path})")