Part of the DEVIN ecosystem
Track: Control · Nature: product
For: Local-first ops, End users
Interface: Service / Dashboard
Path: Local-first ops · step 3/5 — afterdevin-pm, beforedevin-backup
Devin Office
Unofficial community tooling for Devin. Not affiliated with, endorsed by, or sponsored by Cognition AI. Devin is a Cognition AI trademark.
Linux · Personal Windows · Corporate Windows
Part of the awesome-devin ecosystem: the curated hub for the devin-* tools.
A local-first dashboard of active Devin CLI/Desktop sessions and subagents. It reads Devin's session database read-only and renders activity in a browser. Run it on the Devin machine, or send state from a local probe to a private hub.
The current renderer is an SVG circuit view, not a pixel-art sprite renderer. The sprite assets and generator scripts are optional development material; the runtime dashboard does not require them.
Preview
Demo page (synthetic sample data): icaro0310.github.io/demos/devin-office.html
What runs
| Component | Purpose |
|---|---|
devin_office/daemon.py (devin-office) |
Reads the local sessions.db read-only and serves /api/state plus the dashboard. Standalone mode; no tunnel or remote server. |
devin_office/probe.py (devin-office-probe) |
In split mode, polls local state and sends updates to a hub only when state changes. Remote controls are disabled by default. |
devin_office/hub.py (devin-office-hub) |
Serves the dashboard, receives probe state, and exposes health/state endpoints. It binds to loopback by default. |
devin_office/executor.py (devin-office-executor) |
Optional ACP control process for message/spawn/kill requests. Requires an authenticated Devin CLI and explicit opt-in. |
devin_office/index.html |
Self-contained SVG dashboard; no JavaScript/CSS build step. |
devin_office/swapmon.py |
SwapFile Queue collector (Linux /proc, read-only): swap totals, page-in/out rates and the per-process swap queue. |
An optional OFFICE_ECO_URL can supply a separate ecosystem-status JSON payload.
There is no default dependency on another dashboard or maintainer service.
Scheduled one-shot jobs in that payload (e.g. cron_restart entries that sit
stopped between runs) render with a ⏰ marker and count as healthy, not down.
SwapFile Queue
On Linux, the dashboard shows a live SwapFile Queue panel (bottom-right):
swap used/total, page-in/out rates in kB/s, and the processes with the most
memory parked in swap, ranked by VmSwap. Processes that are OOM-immune
(oom_score_adj <= -900) are marked with a green dot. The panel hides itself
on hosts without /proc (e.g. Windows).
Source-only distribution. This project is not published to a package registry. Run it from a checkout:
git clone https://github.com/Icaro0310/devin-control.git
Requirements
- Devin Desktop or Devin CLI installed on the machine whose sessions you want to observe.
- Python 3.10 or newer. The dashboard, probe and hub use the Python standard library; no third-party dependencies.
- The
devinCLI onPATHis required only for the optional ACP executor.
Quick start: one machine
This read-only mode is the simplest way to try the dashboard. From a clone of this repository:
git clone https://github.com/Icaro0310/devin-control.git
cd devin-control/packages/office
pip install -e . # or: uv tool install .
devin-office --port 8788
No install at all also works — the module self-bootstraps its imports, so
python3 src/devin_office/daemon.py --port 8788 from a bare checkout serves
the same dashboard. Then see the Linux or
Windows guide.
Open http://localhost:8788. Stop the server with Ctrl+C. It binds to
loopback and does not write to Devin's databases.
Devin data locations
| Store | Windows | Linux |
|---|---|---|
sessions.db, session_locks/ |
%APPDATA%\devin\cli\ |
$XDG_DATA_HOME/devin/cli/ (default ~/.local/share/devin/cli/) |
ACP message DBs, state.vscdb |
%APPDATA%\Devin\User\ |
$XDG_CONFIG_HOME/Devin/User/ (default ~/.config/Devin/User/) |
credentials.toml (executor only) |
%APPDATA%\devin\ |
$XDG_DATA_HOME/devin/ (default ~/.local/share/devin/) |
OFFICE_DATA_DIR and OFFICE_CONF_DIR override the data and UI-config roots.
Use them when Devin was installed with non-default XDG locations.
Works with Devin alone (Devin-only mode)
The standalone mode above is the whole product for a single machine: one
daemon.py process reads Devin's local stores and serves the pixel office on
127.0.0.1:8788. No VM, hub, tunnel or second machine is required — the
split mode below is strictly optional, for when you want a dashboard on a
different computer.
Security posture of standalone mode: loopback-only bind, read-only access to
Devin's databases, GET endpoints only, and cross-origin reads restricted to
loopback origins (set OFFICE_CORS_ORIGIN explicitly if a dashboard on a
different host/port legitimately needs to fetch /api/state).
Split mode: local probe and private hub
Use this when the Devin machine should send session state to another computer or server. The hub serves the page; the probe stays beside Devin's local data.
Hub (Linux server)
The safe default is loopback. For remote access, bind only to a private
interface such as your VPN/Tailscale address, set a long random token, and
restrict port 8790 with your firewall:
export OFFICE_BIND='<private-interface-ip>'
export OFFICE_TOKEN='<same-random-secret-used-by-the-probe>'
devin-office-hub --port 8790 # or: python3 src/devin_office/hub.py --port 8790
A non-loopback bind refuses to start without OFFICE_TOKEN. The hub uses plain
HTTP: keep it on a trusted private network or place it behind a correctly
configured TLS/authenticating reverse proxy. /api/state and /api/health are
readable to clients that can reach the bound interface; the token protects
POST ingestion and command requests, not those read endpoints.
Probe (Windows PowerShell)
If the hub is reachable over your private network:
$env:OFFICE_HUB = 'http://<private-hub-address>:8790'
$env:OFFICE_TOKEN = '<same-random-secret-used-by-the-hub>'
devin-office-probe --interval 3 # or: py -3 src\devin_office\probe.py --interval 3
For a loopback-only hub, open an SSH tunnel in another terminal and set
OFFICE_HUB to http://localhost:8790.
Probe (Linux)
export OFFICE_HUB='http://<private-hub-address>:8790'
export OFFICE_TOKEN='<same-random-secret-used-by-the-hub>'
devin-office-probe --interval 3 # or: python3 src/devin_office/probe.py --interval 3
For a loopback-only hub, run ssh -N -L 8790:127.0.0.1:8790 <user>@<server> in
a second terminal and leave OFFICE_HUB at http://localhost:8790.
The probe transmits session metadata and tool activity to the configured hub. Do not point it at a public or untrusted host.
Optional session controls
Observation remains read-only. The hub's message, spawn, and kill
endpoints are disabled by default. To enable them, set
OFFICE_CONTROL_ENABLED=1 on both hub and probe, keep the same
OFFICE_TOKEN on both, and use a private network. The local executor starts
devin acp using the authenticated Devin CLI. Never enable controls on a
publicly reachable endpoint.
Configuration
| Variable | Default | Purpose |
|---|---|---|
OFFICE_BIND |
127.0.0.1 |
Hub listen address. A non-loopback address requires a token. |
OFFICE_TOKEN |
unset | Shared token for POST requests (X-Office-Token). Required for non-loopback hub binding. |
OFFICE_CONTROL_ENABLED |
disabled | Opt in to remote message/spawn/kill controls on hub and probe. |
OFFICE_HUB |
http://localhost:8790 |
Probe destination; --hub overrides it. |
OFFICE_INTERVAL |
3 seconds |
Probe poll interval; --interval overrides it. |
OFFICE_ECO_URL |
unset | Optional trusted endpoint returning ecosystem-status JSON. |
OFFICE_CORS_ORIGIN |
loopback only | Access-Control-Allow-Origin for /api/state. Defaults to loopback origins only; never *. |
OFFICE_DATA_DIR |
platform path above | Override Devin's CLI data root. |
OFFICE_CONF_DIR |
platform path above | Override Devin's UI-config root. |
OFFICE_DEVIN_EXE |
devin on PATH |
Devin CLI executable for the optional executor. |
OFFICE_SPAWN_CWD |
repository parent | Working directory for spawned sessions. |
OFFICE_SPAWN_MODE |
smart |
Mode ID for ACP sessions. |
OFFICE_PROMPT_TIMEOUT |
900 seconds |
ACP prompt timeout. |
OFFICE_SSH_HOST |
unset | SSH host alias for the Windows up.pyw tunnel. |
OFFICE_PORT |
8790 |
Local/remote port for the up.pyw tunnel. |
Keep it running
- Windows:
up.pywis an optional split-mode supervisor. SetOFFICE_HUBfor a reachable hub, orOFFICE_SSH_HOSTto create a loopback SSH tunnel. Start it from Task Scheduler after defining the required environment variables for that user. - Linux: run the probe under a user service manager such as
systemd --user. Use anEnvironmentFilewith permissions restricted to your user forOFFICE_HUBandOFFICE_TOKEN; do not put a real token in a committed unit file. - Hub: use a service manager (systemd, PM2, or equivalent) and keep its bind/firewall policy private.
Troubleshooting
sessions.db not found: check the paths above or setOFFICE_DATA_DIR.- GUI sessions absent: check
OFFICE_CONF_DIR; the CLI database can still work by itself. devinnot found: install/authenticate the Devin CLI or setOFFICE_DEVIN_EXE. This is needed only for controls.- Hub rejects probe POSTs: confirm
OFFICE_TOKENis the same on both sides. - No ecosystem-status nodes: that integration is optional; set
OFFICE_ECO_URLonly if you have a compatible status endpoint.
License and credits
MIT — see LICENSE. Furniture artwork is credited in the source; the optional sprite-generation utilities are not required to run Devin Office.
When to use this
- You run Devin CLI or Desktop on this machine and want one live view of all active sessions, subagents, and tool calls.
- You want a dashboard with zero install friction: Python 3.10+ stdlib only, no pip packages, no JS build step.
- You need a strictly read-only observer that never writes to Devin's stores.
- You want the board visible on a second machine over a private network (split probe + hub mode).
When NOT to use this
- You need to search or analyze past sessions — devin-office shows live
state; use
devin-searchordevin-metricsfor history. - You want remote session control out of the box — message/spawn/kill are disabled by default and require explicit opt-in on both ends.
- The machine has no Devin CLI/Desktop install — there is nothing to read.
FAQ
What is devin-office? A local dashboard that renders your live Devin
sessions as an SVG circuit board in the browser. One daemon.py process reads
Devin's session databases read-only and serves the page on 127.0.0.1:8788.
Does devin-office send my session data anywhere? No, in standalone mode. Everything runs on loopback against your local Devin stores. The optional split mode (probe + hub) sends session metadata only to a hub address you configure; never point it at a public or untrusted host.
Does devin-office need an API key or extra dependencies? No. The
dashboard, probe, and hub use only the Python standard library. The devin
CLI is needed solely for the optional, opt-in executor that enables
message/spawn/kill controls.
Can it change or kill my Devin sessions? Only if you explicitly enable it.
Observation is read-only; the control endpoints are off by default and require
OFFICE_CONTROL_ENABLED=1 plus a shared token on both hub and probe.
If this saved you debugging time, a ⭐ on the repo helps others find it.
procmap.py (OF-1) attributes running processes to Devin sessions:
session_locks/*.lock → owner PID → /proc process tree (+ RSS per
child) → sessions.db. Live vs dead locks, --dead-only, --json.
Read-only — nothing is signalled or killed; off-Linux falls back to
tasklist/ps with less detail. Tool-call attribution is lock-PID +
children inference (heuristic); container-level attribution is not
currently shipped.
Metadata
Release files for devin-office 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| devin_office-0.1.0.tar.gz | 4.2 MB | With provenance | Details for devin_office-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| devin_office-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for devin_office-0.1.0-py3-none-any.whl |
Total release size: 8.4 MB
Release files / devin_office-0.1.0.tar.gz
| Download URL | devin_office-0.1.0.tar.gz |
|---|---|
| Size | 4.2 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e0da1eb720249a5ff464f42e62b08cca115c2badc9d5130d7cd9e48f7c7884f5
|
|
BLAKE2b-256 checksum How to use checksums |
eff9ca5f548736ca47d8c6ce3758b76449d0c26f28e3d4f624fdfa6f2ae80a3f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 20, 2026.
Transparency logRelease files / devin_office-0.1.0-py3-none-any.whl
| Download URL | devin_office-0.1.0-py3-none-any.whl |
|---|---|
| Size | 4.2 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
fdab335f6f5443541926d1f0a2c484fdb746061938aaec6e0353ca67a8778259
|
|
BLAKE2b-256 checksum How to use checksums |
1a8bea66be17f2fc5e9acd86f74cddd387b0cc791829722c8c31036cf62681e1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 20, 2026.
Transparency logSecurity for devin-office 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for devin_office-0.1.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 20, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.