Interactive sandbox shell in your local terminal

pip install declaw

import fcntl
import os
import signal
import struct
import sys
import termios
import time
import tty

from declaw import Sandbox
from declaw.sandbox.commands.models import PtySize


def term_size() -> PtySize:
    """Current cols/rows of the local TTY."""
    try:
        cr = struct.unpack(
            "hh", fcntl.ioctl(sys.stdout.fileno(), termios.TIOCGWINSZ, b"....")
        )
        return PtySize(cols=cr[1], rows=cr[0])
    except Exception:
        return PtySize(cols=120, rows=30)


def main() -> int:
    if not sys.stdin.isatty():
        print("stdin is not a TTY — run this in a real terminal", file=sys.stderr)
        return 2

    with Sandbox.create() as sbx:
        print(f"[declaw] sandbox: {sbx.sandbox_id} — Ctrl-D to quit\n", flush=True)

        handle = sbx.pty.create(
            size=term_size(),
            on_data=lambda b: (sys.stdout.buffer.write(b), sys.stdout.buffer.flush()),
            timeout=3600,
        )

        # Propagate local window resizes to the sandbox via SIGWINCH.
        signal.signal(signal.SIGWINCH, lambda *_: handle.resize(term_size()))

        fd = sys.stdin.fileno()
        old_attrs = termios.tcgetattr(fd)
        try:
            tty.setraw(fd)
            time.sleep(0.1)  # let the PTY print its first prompt
            while True:
                data = os.read(fd, 1024)
                if not data:
                    break
                if data == b"\x04":          # Ctrl-D → graceful remote exit
                    handle.send_stdin("exit\n")
                    break
                handle.send_stdin(data)
        finally:
            termios.tcsetattr(fd, termios.TCSADRAIN, old_attrs)

        result = handle.wait(timeout=5)
        print(f"\r\n[declaw] pty exited: {result.exit_code}", flush=True)
    return 0


if __name__ == "__main__":
    sys.exit(main())

export DECLAW_API_KEY="your-api-key"
export DECLAW_DOMAIN="api.declaw.ai"
python pty_live.py