← AI Catalyst C3All programsHomeSearch
AI Catalyst C3·Core Session - Week 20·3:06:27

How to Build Vertical Harnesses: The Car Analogy, a Reusable Folder Template, and Live Builds that Print a Keycap, Replace a TV's Bloatware, and Reach Physical Devices Over SSH and Tailscale

Harshith Vaddiparthy Instructor - runs his own Jarvis (a Hermes agent on an Azure VM), works at the company Kenzai (private code base), uses Codex CLI as his main harness; the same mentor as the Week 19 Jarvis session · Vikash Outskill host - audio checks, relays chat, closes with the CSAT poll · Cody Shah, Praful Thakkar, Sara Sebastian, Rahul Kapoor, rahul pardeshi, Syed Hasan, Veronica, Stephen Sequeira, Gautam, Achint Choksy, Keisuke Inomura, Suraj Menon, Rajesh Participants whose questions, suggestions or builds are used (names as in the chat export; ASR variants)

The short version

  1. Definition: a harness is everything around the LLM that helps it do a job - context, tools, controls and feedback. Car analogy: the model is the engine; ChatGPT or Claude Cowork is the stock car; Claude Code and Codex are the tunable F1 car; a vertical harness is a kit you assemble for one domain and one recurring task (a support specialist that turns a damaged-lamp ticket into a reviewable resolution pack). Harness beats a free-roaming agent on reliability because it has one job (0:25-0:31).
  2. Codex CLI is itself a harness and is fully open source (github.com/openai/codex); the Claude Code harness is not, as far as he checked. The CLI feels faster, uses less memory (his MacBook overheated with three app workflows) and exposes /fast; because the harness is open source you can modify it to cut token use (0:33-0:54).
  3. The folder is the harness. Template from a Codex prompt: TASK.md (purpose and decisions), README, AGENTS.md, config, a domain folder, workflows, prompts, evals, operations, run records, YAML GitHub Actions on a cadence; the five that matter are task, config, domain, workflows and evals. Ask Codex to show the tree before building. Published as the public repo Vertical-Harness (23 files) with an examples directory; one standalone repo per specialised harness (0:41-1:02, 1:20-1:24).
  4. Build 1 - 3D printing: download a 3MF from MakerWorld, point the harness at it, get a local interactive viewer (rotate, plate view), then print on a Bambu Lab A1 combo, slot 4 olive PLA, with a camera snapshot. Architecture: MacBook -> SSH -> Mac mini (always on the home Wi-Fi) -> LAN-only mode -> printer; Tailscale across devices; a Raspberry Pi would do. The 25-minute print was a keycap assembled live as an Escape button (1:06-1:52, 2:33-3:00).
  5. Build 2 - Android TV: the open-source tv-vibehack launcher plus one prompt ('convert this into a vertical harness that connects to my Hermes agent') gave a bloatware-free TV with a button that shows Jarvis sessions and emails; one repo for learners, built without touching his live TV. Samsung needs a different harness; Roku/Android work; developer mode is 7 taps. Security debate: Tailscale plus a firewall, default router passwords, and Anthropic's 'self-replicating AI' research (2:08-2:40).
  6. Builds 3 and 4: the 'anatomy' visual skill plus the presentation harness and HyperFrames for hyper-frame slideshows with presenter notes, and a financial-modelling harness from a public startup-financial-model skill; ideas: a LinkedIn-post harness after each session, combining the anatomy skill with the printer. Wrap: a printed, assembled keycap on camera and a promise of one repo plus images on Drive (2:39-3:02).

At a glance, three clicks deep

Skim here first: the closed row is the glance, open is the study card with the key points and timestamps, and the ↓ link drops to that concept's full write-up below.

01What a harness is: the engine-and-car analogy, from stock car to F1 kit, and why a vertical harness beats a free-roaming agentA harness is the model plus the context, tools, controls and feedback loop around it;0:25:00›

A harness is the model plus the context, tools, controls and feedback loop around it; a vertical harness narrows all of that to one domain and one repeating job.

Model is the engine; stock car vs tunable car vs assembled kit (0:25-0:29)

Context, tools, controls and feedback (0:25-0:27)

Vertical harness: one domain, one recurring task, reviewable output (0:29-0:31)

More reliable than a general agent with many tools (0:29-0:31)

↓ Full write-up of this concept

02Codex CLI is a harness (and open source): why he prefers the terminal to the app, and how Hermes can drive itThe Codex CLI is an open-source agent harness that the Codex app wraps;0:33:00›

The Codex CLI is an open-source agent harness that the Codex app wraps; running it in a terminal is lighter, faster to tune and scriptable by other agents.

Install from the repo command; sign in or use an API key (0:35-0:41)

Open source: you can modify it, e.g. to reduce tokens (0:37-0:39, 0:50-0:52)

Claude Code's harness not open source as far as he knows (0:37-0:39)

CLI: lower memory, /fast, multiple tabs, less heat (0:50-0:54)

Hermes can run the CLI in a sandbox (0:39-0:41)

↓ Full write-up of this concept

03The folder is the harness: the TASK.md, config, domain, workflows and evals template, built from a Codex prompt and published as a reusable repoA harness is a version-controlled folder of instructions, config, domain rules, workflows and evals that an…0:41:00›

A harness is a version-controlled folder of instructions, config, domain rules, workflows and evals that any coding agent can open and run.

Ask for the tree first, then build (0:41-0:47)

Files: TASK.md, README, AGENTS.md, config, domain, workflows, prompts, evals, operations, templates (0:43-0:47)

YAML workflows become GitHub Actions on a cadence (0:43-0:45)

Public repo with an examples directory; one repo per specialised harness (0:54-1:02, 1:20-1:24)

Folder structure replaces agents; /init is a command, not a folder (0:58-1:00)

↓ Full write-up of this concept

04Live build 1, the 3D-printing harness: a MakerWorld 3MF file, a local interactive viewer, then a real print from slot 4A vertical harness for hardware pairs a task file and device rules with a local viewer and a guarded print…1:08:00›

A vertical harness for hardware pairs a task file and device rules with a local viewer and a guarded print command, so the agent can inspect, customise and print a model.

MakerWorld 3MF to local interactive viewer with plate view (1:10-1:22, 1:50-1:54)

One repo per harness, linked from the template's examples (1:20-1:24)

Printing from slot 4 plus built-in camera snapshot (1:54-2:02)

Material profile blank in slot 4 until filament loads (1:58-2:00, 2:12-2:14)

Keycap printed and assembled as an Escape button (2:55-3:02)

↓ Full write-up of this concept

05How an agent reaches a device: MacBook to Mac mini over SSH, Mac mini to printer over LAN-only mode, Tailscale across devices, and why a home server beats a cloud HermesTo drive a physical device from anywhere, an agent connects over SSH to a small always-on machine on the de…1:32:00›

To drive a physical device from anywhere, an agent connects over SSH to a small always-on machine on the device's own network, which speaks to the device locally.

MacBook to Mac mini over SSH; mini to printer over LAN-only mode (1:32-1:42)

Printer settings: LAN-only plus developer mode (1:34-1:36)

Raspberry Pi works equally; Mac mini used as the server (1:36-1:38)

Tailscale on every device; add a firewall; change default router passwords (1:38-1:42, 2:27-2:32)

Cloud Hermes cannot see home Wi-Fi; Tailscale can bridge; local DGX Spark as the long-term plan (2:12-2:14, 2:25-2:29)

↓ Full write-up of this concept

06Live build 2, the Android TV harness: one prompt turns an open-source launcher into a bloatware-free TV that shows your JarvisFeed a working open-source repo and the vertical-harness template to a coding agent, and ask for a harness…2:08:00›

Feed a working open-source repo and the vertical-harness template to a coding agent, and ask for a harness that adds the task, rules, evals and a safe test path around it.

tv-vibehack launcher plus a Jarvis button (2:08-2:10, 2:12-2:20)

Name it for the target (Android TV harness) so people do not assume all TVs (2:16-2:18)

Emulator test and a protect-my-live-TV instruction (2:33-2:37)

Samsung and Roku differences; developer mode via seven taps (2:23-2:25, 2:43-2:45)

Single learner repo that contains the original source and the harness (2:49-2:51)

↓ Full write-up of this concept

07When agents reach physical devices: the Tailscale-plus-firewall debate and Anthropic's self-replicating-AI researchPhysical-device harnesses inherit the security of the agent that controls them, so network segmentation, a…2:27:00›

Physical-device harnesses inherit the security of the agent that controls them, so network segmentation, a firewall and strong account protection come before convenience.

Devices on the LAN are visible but not commandable without the controlling account (2:27-2:31)

Tailscale plus a firewall; change default router password (2:29-2:31, 2:33-2:35)

Anthropic self-replicating-AI article shared as a warning (2:29-2:33)

Security not yet configured on the TV harness (2:37-2:39)

↓ Full write-up of this concept

08Builds 3 and 4: the anatomy visual skill, a presentation harness with HyperFrames, and a financial-modelling harness from a public skillWrap a public skill or repo in the vertical-harness template, give it a runnable output and evals, and you…2:39:00›

Wrap a public skill or repo in the vertical-harness template, give it a runnable output and evals, and you have a harness others can fork.

Anatomy skill: interactive exploded diagrams (2:39-2:43)

Presentation harness with HyperFrames slideshows and presenter notes (2:45-2:49)

Financial-modelling harness from a public skill; unclear shape, run in background (2:53-2:57)

LinkedIn-post harness idea; images on Drive (2:51-2:55)

↓ Full write-up of this concept

The concepts in full

01

What a harness is: the engine-and-car analogy, from stock car to F1 kit, and why a vertical harness beats a free-roaming agent

0:25:00

The model is the engine. Everything bolted around it is the harness - and you can change the wheels.

Harshith's definition: a harness is everything around a large language model that helps it do a particular job; it carries context (what the model knows), tools (what it can touch) and controls and feedback (how you steer and check it). The analogy slides: the engine is the LLM; a stock car is ChatGPT or Claude Cowork as you get them at sign-up; an F1 car is Claude Code or Codex - a vehicle you can tune; the 'assemble the kit' slide is building your own harness. A vertical harness specialises the system for one domain and a recurring task, for example support resolution: order, ticket records and the current refund policy in, a reviewable resolution pack out - a support specialist that turns a damaged-lamp ticket into a resolution. He prefers this to a bespoke agent: an agent with many specialised tools can hallucinate or go off-track, while a harness has one job it does reliably. The deck itself was built by his presentation-building harness and he offers the visual skill to anyone who types yes in chat. Practice files for the support example were part of the PDF; the slides are promised as a resource.

Worked example · from the session

Support specialist: open ticket, find order, check refund policy, produce a reviewable resolution pack - the harness holds the task file, the policy and the checks.

Why it matters

Gives the cohort a vocabulary for what they have been building since Week 19 and Session 15.

02

Codex CLI is a harness (and open source): why he prefers the terminal to the app, and how Hermes can drive it

0:33:00

If you use the Codex app you are already using the harness underneath it - and OpenAI has published it.

He compares the Codex app (plugins, skills, a visual chat) with the Codex command-line interface, installed with a one-line command from the repo; sign in with the same ChatGPT account or use an API key (he used a personal API key for this demo). His claim: OpenAI ships new skills and plugins in the CLI harness first and the app later, and the whole Codex harness is open source (github.com/openai/codex, 'a lightweight coding agent that runs in your terminal'), so you can build your own harnesses or tune Codex itself, including to reduce token consumption. He checked and does not think Claude Code's harness is open source. Hermes can call the Codex CLI, and his Jarvis controls it in a sandbox because the harness is built for OpenAI's models. Why the CLI over the app: faster feel, /fast mode and model selection, several terminal tabs, and lower memory and heat (the app with three running workflows made his MacBook very hot). The slash commands: /init creates the agents/CLAUDE file and is a command, not a folder. Version quoted as '1.6.16' on screen (as heard); model GPT 6.1. A participant notes the CLI does not load a UI, so fewer turns; he agrees but is not sure which consumes more tokens.

Worked example · from the session

He asked the Codex app to install the Codex CLI on his computer, and it did.

Why it matters

Explains the tooling choice behind every build later in the session.

03

The folder is the harness: the TASK.md, config, domain, workflows and evals template, built from a Codex prompt and published as a reusable repo

0:41:00

'Show me the folder structure before you build anything' - and then rename it and let it fill the template.

Method: create an empty folder, open it in Codex CLI, and prompt: treat this folder as a template for a vertical harness, add every file needed, start with a task.md, and first show the folder tree including where tasks run, who has access, the model and so on. Codex returns a tree he accepts, then he asks it to rename the folder to vertical-harness and fill it in. The template contains: TASK.md (the purpose and decisions to fill in - the one file you cannot skip), README.md, AGENTS.md, an ignored environment-variables file, configuration (model, access), a domain folder (what the domain is, rules, evidence), workflows (including YAML files that become GitHub Actions and can run on a cadence - every minute, every hour, on task completion), prompts and specialist system prompts, evals (the harness itself checks the job was done in the intended way), operations (monitoring set-up), templates, and decisions and run records. The five he insists on: task, configuration, domain, workflows, evals. YAML is the superset of JSON that is easier to read for configs; the folder structure itself replaces agents as the unit. He pushes it to GitHub as a public repo (harshith-vaddiparthy/Vertical-Harness, 23 files verified) with a README on how to fork it; the next harness is built by giving Codex a use case and telling it to follow this structure. Decision in Q&A: one standalone repository per specialised harness, with the main repo as the template plus an examples directory that links to each; do not push to GitHub mid-build.

Worked example · from the session

'Treat this folder as a template to create a vertical harness; show me the tree before building; start with a task.md.'

Why it matters

The repeatable scaffold the later builds, and learners' own harnesses, are made from.

04

Live build 1, the 3D-printing harness: a MakerWorld 3MF file, a local interactive viewer, then a real print from slot 4

1:08:00

He printed a nuclear-launch-switch keycap a participant suggested, and it became an Escape button before the class ended.

He has been 3D printing for about a month (a Bambu Lab A1 combo with four filament slots; filament about 10 USD a reel; the printer does not ship with filament) and says earlier prints without a harness had stringing and chips; a harness can know the nozzle and temperature and reduce this. The steps: choose a model on MakerWorld (the keycap, suggested by Sara), download the 3MF (a 3 MB file with base, cover and key parts and a Bambu P2S profile he does not recognise), then a 'word-vomit' prompt to Codex: confirm you understand, give suggestions, and then - when you point me at a file - open an interactive local-host 3D viewer I can rotate and zoom with top, front, side and underside views and a print-plate view showing orientation and size on the bed, then let me customise the model and export. Codex restates it and recommends one repo per harness; it creates a 3d-printing-harness folder (agents, config, domain rules, prompts, an app folder with a local web viewer, and a front-end design skill used for the interface). Participants built parallel versions (Rahul's skull model, Syed's dark-mode viewer). Printing: with the Mac mini wired up, he asks Codex to use the olive filament in slot 4 and to take a photo with the printer's built-in camera; Codex finds slot 4 blank in the material profile, slices an A1 job, uploads it and starts; a 25-minute print followed. Closing ideas: save nozzle travel by grouping parts closer; add an average print-time readout; print a key-puller; combine this with the anatomy skill to print mechanical parts.

Worked example · from the session

'Use the olive filament in slot 4, start the print now, and put a camera image on my desktop.'

Why it matters

Shows a harness reaching into the physical world through one clear task file.

05

How an agent reaches a device: MacBook to Mac mini over SSH, Mac mini to printer over LAN-only mode, Tailscale across devices, and why a home server beats a cloud Hermes

1:32:00

Wi-Fi alone does not make ChatGPT talk to your printer. Something on the same network has to be the hands.

The architecture he draws (red lines on the slide): the MacBook controls a Mac mini over SSH, and the Mac mini controls the 3D printer over the local network. Printer set-up: connect the Bambu app to Wi-Fi, then on the printer's small screen turn on LAN-only mode and developer mode; after that Bambu cloud no longer sees it (the account shows it as disabled), and you ask Codex (or Hermes) to scan the Wi-Fi for connected devices and connect to the printer. He introduced the Mac mini because the harness only worked while the MacBook was on the same Wi-Fi - at a cafe it stopped. The Mac mini is always on the home network and acts as a server; a Raspberry Pi would do the same. In the Codex app, Settings, Connections lets you add SSH hosts (a virtual machine, the mini); the same SSH route reaches any server. Security: use Tailscale on all your devices so only your account's machines can reach each other. A participant (Shaquille) argues Tailscale only covers devices that run it, so the printer itself is not protected; he decides to add a firewall as well because his Hermes has access to all physical devices and a stolen Tailscale account would open everything. Hermes Q&A: a Hermes on a cloud server cannot see your home Wi-Fi - that is why the Mac mini exists - though Tailscale could bridge it, and the same device could be driven by Hermes on Hostinger or by Codex directly if the computer is already on the LAN. He plans to move to an always-on local DGX Spark-class box (about 7,000 USD now, said to have doubled) rather than depend on Azure.

Worked example · from the session

MacBook (anywhere) -> SSH -> Mac mini (home Wi-Fi) -> LAN-only mode -> Bambu printer, with Tailscale on the first two.

Why it matters

The missing wiring explanation behind 'I put my agent on my TV and printer'.

06

Live build 2, the Android TV harness: one prompt turns an open-source launcher into a bloatware-free TV that shows your Jarvis

2:08:00

Previously the TV was full of ads. Now the home screen shows his Codex sessions and important emails, with one button to a plain TV.

Inspired by a tweet from Gathin and the GitHub repo tv-vibehack (credit to the author, Gathin23), he swapped his TCL Android TV's ad-filled launcher for a minimal one with only the apps he uses (YouTube, Netflix, Hotstar, Prime) and a button that opens the Jarvis view; he asked for a liquid-glass look so it resembles Apple TV. The Jarvis view shows live Codex sessions running on his MacBook and some emails, because the harness and his Hermes agent are connected to the same CLI and mini. To make it teachable: new chat in the Desktop vertical-harness folder, paste the repo link and prompt: integrate this code base into a vertical harness connectable to my Hermes agent, ignore Hermes configuration for now, call it Android TV harness; also 'do not change the configuration of my current Android TV'. Codex built the folder with evals, domain and artifacts, hit launcher compatibility issues (a missing Android TV launch entry), tested on an emulator (APK installed on Android TV 14; home-selection quirk), and fetched the TV's serial number. Published as one repo for learners that contains the original launcher source with their changes, the Jarvis button, executable harness and device tools. Q&A: Roku TVs work, Samsung (Tizen) needs a different implementation and developer mode (tap the build number seven times; files may need a USB stick); the same approach could add tasks from the TV but he had not configured it, and he has not worked on its security. Chat idea: harnesses as paid products.

Worked example · from the session

'Convert this repo into a clear vertical harness I can later connect to my Hermes agent; call it Android TV harness.'

Why it matters

A one-prompt example of 'repo plus template equals harness'.

07

When agents reach physical devices: the Tailscale-plus-firewall debate and Anthropic's self-replicating-AI research

2:27:00

My Hermes can reach my printer and my TV. So whoever reaches my Hermes can reach them too.

During the TV build the room raises security repeatedly: is Wi-Fi shared with neighbours a risk, can anyone on the network drive the printer, and what stops a bad actor. His position: anyone on the network can see devices but only his Tailscale-connected Hermes can command them because the printer is on LAN mode and the commands arrive through the mini; he concedes a stolen Tailscale account would give full access, so a firewall should be added and the router's default password changed. He also recalls an Anthropic research piece on AI models that may replicate themselves across smart devices (smart fridge, air fryer, Android TV boxes) on one Wi-Fi network, and shares the article link (as he describes it - the claims are unverified here); his takeaway is that firewalls and device isolation become important once harnesses control physical devices, and that models may not need big GPUs if they can spread over many small ones. He says he had not focused on security for the TV harness and will publish guidance with the repo.

Worked example · from the session

A participant: 'Dyson cleaner can be used to hack your Hermes' - he replies it is possible and cites the Anthropic piece.

Why it matters

The honest limit on 'put an agent on everything'.

08

Builds 3 and 4: the anatomy visual skill, a presentation harness with HyperFrames, and a financial-modelling harness from a public skill

2:39:00

A skill is not yet a harness. A skill connected to your presentation workflow, with a runnable output, is.

Harness 3 starts from the 'anatomy' skill (a public repo) that draws interactive exploded views - a mechanical watch whose movement can be wound, a sorting desk, a Macintosh, merge sort, a token bucket, easing curves, a public key, the CSS box model, even a Starship. He says his own harness here is not special: the skill with his presentation flow. To lift it, he pastes the repo link into Codex with his Desktop vertical-harness template and asks for a presentation harness for technical decks and website design; Codex asks whether he wants a runnable HyperFrames slideshow with navigation and presenter notes, and he agrees - HyperFrames (by Adrian; agent-friendly video and slides written in HTML, a Remotion substitute). Ideas: connect the anatomy skill to the printer harness to print real mechanical parts. Harness 4 was the class's pick, financial modelling: he searches skills, finds a startup financial-modelling skill (3-5 year projections with revenue assumptions) and a Claude office-style skill, pastes both links with the template and asks for a harness connectable to Hermes, pushed as a standalone repository linked to the template; he admits he is not yet clear how to shape it and leaves it running. Wrap ideas: a harness that drafts the LinkedIn post and blog after every repo or session (build in public), asking Hermes to automate it, and a 'bring your own 3D printer' extension; he will share all repos, the Drive images (converted from HEIC) and the notes.

Worked example · from the session

'Look at my vertical-harness folder, link the anatomy skill, and build a presentation harness for technical decks and website design.'

Why it matters

Shows the template turning any skill or repo into a shareable harness.

Tools referenced

ToolCoverageMomentContext
Codexdemonstrated0:33:00CLI and app; main build tool; open-source harness
GitHubdemonstrated1:00:00Public template repo, Actions YAML, one repo per harness
Bambu Lab A1demonstrated1:08:004-slot combo printer, LAN-only mode, built-in camera
MakerWorlddemonstrated1:10:003MF model downloads
tv-vibehackdemonstrated2:12:00Open-source Android TV launcher repo by Gathin23
Anatomy skilldemonstrated2:39:00
Excalidrawdemonstrated1:02:00Used for the build plan; paywall annoyance prompted a 'build my own' idea
Hermesexplained0:39:00Jarvis brain on Azure; can drive the Codex CLI; connected to the TV launcher
Claude Codeexplained0:27:00Tunable F1 car in the analogy; harness not open source as far as he knows
Tailscaleexplained1:38:00
SSHexplained1:36:00
Mac miniexplained1:32:00Always-on home server, replaces a Raspberry Pi
HyperFramesexplained2:47:00
Claude Coworkmentioned0:27:00Stock car
ChatGPTmentioned0:27:00Stock car; Codex shares the account sign-in
Azurementioned2:25:00Hosts his Hermes today
Hostingermentioned2:12:00
DGX Sparkmentioned2:25:00Plan for a local always-on box; price as stated
Raspberry Pimentioned1:36:00

Action items

    Resources mentioned

    Resources
    • docVertical-Harness (public template repo, GitHub)
    • docCodex CLI (OpenAI, open source)
    • docHarness engineering article
    • doctv-vibehack (Android TV launcher) and the originating X post
    • docMakerWorld - Nuclear launch switch keycap
    • docAnthropic - self-replicating AI research
    • docPresentation PDF (vertical harnesses, car analogy)
    • docDrive folder of session images and per-harness repos
    • docPrompt: treat the folder as a vertical-harness template
    • docPrompt: convert a repo into a vertical harness

    Extraction notes

    This page was built from an auto-generated transcript, which garbles product and people's names. Those were corrected silently in everything above and logged here for transparency. The warnings flag claims that were true on the recording day but change fast.

    Transcript corrections applied

    The transcript saysThe trainer actually means
    hardness / hardness folderharness (systematic)
    Harshad / Ashit / Anshul / AshishHarshith Vaddiparthy (instructor)
    codecs / codecCodex
    cloud / floor / plotClaude
    Tail scaleTailscale
    Kenzai / KenzoKenzai (his company; as spelled in chat)
    tailscale on every device vs Hermes on Azuresee concept w20b-reaching-devices-ssh-lan-tailscale
    Bamboo lab / BambuBambu Lab
    Arbex / Java's / Jarvis buttonHermes agent and the Jarvis view
    TB harness / TV web hack / NRTB launcherTV harness / tv-vibehack / the upstream launcher
    HixbyHiggsfield (from Ep03; not used here)

    True on recording day — verify before relying