knowop🔌

One command to log in to KnowOp, connect your computer, and run your agents and GPU jobs where Chat can reach them.

Quick Start

# Mac:
#   # Required for quick install.
#   brew install uv

# Ubuntu/Debian:
#   # Required for quick install.
#   sudo apt-get install -y curl
#   curl -LsSf https://astral.sh/uv/install.sh | sh

uvx knowop connect

uvx knowop connect runs knowop without installing it. To keep the command for every day, install it:

uv tool install knowop
# Alternatively: python -m pip install knowop

Use

knowop connect          # this computer: log in, enroll, serve its terminal and commands
knowop run claude       # Claude Code in this folder, recorded, reachable from Chat
knowop run codex        # the same for Codex
knowop job submit -- python train.py   # a job on a GPU node, from this repository
knowop status           # server, account, this computer's connection

knowop connect prints a code; approve it in your browser, on any device. That one approval logs you in, enrolls this computer and confirms it. Until you press Ctrl-C, the computer's terminal opens in the web app, and it runs the commands the server's assistant sends; --no-exec serves the terminal only. knowop connect acme does the same on https://acme.knowop.ai. A computer with no browser, such as a box, pipes an enrollment token to knowop connect instead, and joins with no login.

Plain knowop login logs in to https://alpha.knowop.ai; knowop login acme to https://acme.knowop.ai, and knowop login URL to any server. Use it on a computer you will not connect, where only your agents work. A later knowop connect there enrolls the computer with that login's key, and it waits until you confirm it in the web app. A first knowop run logs in too.

Commands

Every command takes --help; knowop run claude --help and knowop job submit --help show the runner's own.

knowop keeps one login and uses it for every command. It saves the key as a trax profile, and trax's own current profile stays as it was: knowop never acts on a server it did not log in to.

Extras

The browser terminal relays through the server. knowop[direct] adds a direct link between the browser and this computer, so typing feels immediate:

uv tool install 'knowop[direct]'

Layout

knowop calls the server through trackinizer's Client, as trax does, and never runs trax. trax machine and trax job say they moved out of trax.

Development

uv sync --all-groups --all-extras
uv run pytest

See also

Sibling projects in the rekursiv-ai family:

• trackinizer — Centralized agent database for tracking inquiries, work, and the evidence behind conclusions; knowop's trax and its client come from it.
• sagent — The self-mutating multi-provider coding-agent CLI and typed Python library.
• wesearch — Web search, resilient page fetch, and scholarly-paper lookup without a browser stack.