Files
nixos-config/hosts/m3-hermes/services/t3code.nix
T
m3ta-chiron c310ce57f4 feat(m3-hermes): T3 Code cockpit — t3 serve systemd service, mesh-only
Three-lane agent setup (interactive cockpit / autonomous workers / Hermes
control lane): T3 Code server runs on m3-hermes as a systemd service under
the m3tam3re user, reachable only from the NetBird mesh (direct pairing,
no T3 Connect cloud relay).

- hosts/m3-hermes/services/t3code.nix: t3 serve on port 3773 (port
  registry), User=m3tam3re, keyless m3ta-gateway opencode config for
  harnesses, claude-code/opencode2 in service PATH
- ports.nix: t3code = 3773
- fix netbirdRange in ai-memory.nix + hermes-dashboard.nix: the fleet
  mesh actually runs in 100.81.0.0/16 (wt0 kernel route), the previous
  100.64.0.0/16 rules never matched any real peer

One-time steps after deploy (documented in the module header):
sudo -u m3tam3re claude auth login; t3 pair for client devices.
2026-10-31 11:18:49 +01:00

109 lines
3.9 KiB
Nix

# T3 Code server (https://t3.codes) — interactive coding-agent cockpit.
#
# Part of the three-lane agent setup (agreed 2026-10-26):
# - Lane 1, interactive cockpit: T3 Code on m3-hermes, reached over the
# NetBird mesh via direct pairing (no T3 Connect cloud relay).
# - Lane 2, autonomous workers: herdr sandbox (see herdr-sandbox.nix).
# - Lane 3, control & inbox: Hermes via Matrix (unchanged).
#
# Flow: T3 desktop/mobile app ──NetBird mesh──▶ wt0 :3773 (this server).
# The server binds 0.0.0.0, but the firewall admits the port for mesh
# peers only — same posture as ai-memory and the hermes dashboard.
#
# One-time interactive steps after deploy (deliberately NOT declarative):
# - Pair clients: `sudo -u m3tam3re t3 pair` (or take the pairing URL
# from `journalctl -u t3code` after first start) and add the
# environment in the T3 app via the printed URL/QR code.
# - Claude Code login once: `sudo -u m3tam3re claude auth login`
# (state persists in /home/m3tam3re/.claude).
# - OpenCode needs no login: ~/.config/opencode/opencode.jsonc is
# symlinked below to the keyless m3ta-gateway endpoint.
{
config,
pkgs,
...
}: let
# NetBird mesh range of this fleet (kernel route: 100.81.0.0/16 dev wt0).
netbirdRange = "100.81.0.0/16";
port = config.m3ta.ports.get "t3code";
# Keyless LLM endpoint for harnesses spawned by T3 Code — the same
# endpoint the herdr sandbox workers use (the proxy injects provider
# keys server-side; budget caps live in the NetBird policy).
cockpitOpencodeConfig = pkgs.writeText "opencode.jsonc" (builtins.toJSON {
"$schema" = "https://opencode.ai/config.json";
provider = {
m3ta-gateway = {
npm = "@ai-sdk/openai-compatible";
name = "m3ta-gateway";
options = {
baseURL = "https://downy-cardamom.p.m3ta.dev/v1";
apiKey = "none";
};
models = {
claude-sonnet-5 = {
name = "Claude Sonnet 5";
};
claude-opus-5 = {
name = "Claude Opus 5";
};
};
};
};
model = "m3ta-gateway/claude-sonnet-5";
});
in {
# CLI on the system for interactive admin (t3 pair, t3 service status)
# plus the harnesses T3 Code orchestrates. Login shells need them for
# the one-time auth flows documented in the header.
environment.systemPackages = [
pkgs.llm-agents.t3code
pkgs.llm-agents.opencode2
pkgs.llm-agents.claude-code
];
# OpenCode provider config for the cockpit user (mirrors herdr-sandbox).
systemd.tmpfiles.rules = [
"d /home/m3tam3re/.config 0750 m3tam3re users -"
"d /home/m3tam3re/.config/opencode 0750 m3tam3re users -"
"L+ /home/m3tam3re/.config/opencode/opencode.jsonc - - - - ${cockpitOpencodeConfig}"
];
# ── T3 Code server (system service, cockpit user) ────────────────────
systemd.services.t3code = {
description = "T3 Code server (interactive coding-agent cockpit)";
after = ["network-online.target"];
wants = ["network-online.target"];
wantedBy = ["multi-user.target"];
serviceConfig = {
User = "m3tam3re";
Group = "users";
WorkingDirectory = "/home/m3tam3re";
ExecStart = "${pkgs.llm-agents.t3code}/bin/t3 serve --host 0.0.0.0";
Restart = "on-failure";
RestartSec = "5";
};
environment.T3CODE_PORT = toString port;
# Harness CLIs and git for the agents T3 Code spawns.
path = with pkgs; [
git
llm-agents.opencode2
llm-agents.claude-code
];
};
networking.firewall = {
extraCommands = ''
# Allow t3code only from Netbird mesh VPN
ip46tables -A nixos-fw -p tcp --dport ${toString port} -s ${netbirdRange} -j nixos-fw-accept
'';
extraStopCommands = ''
ip46tables -D nixos-fw -p tcp --dport ${toString port} -s ${netbirdRange} -j nixos-fw-accept 2>/dev/null || true
'';
};
}