332 lines
13 KiB
HTML
332 lines
13 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="en">
|
|
<head>
|
|
<meta charset="UTF-8">
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
|
|
<title>One Binary to Rule Them All: Our Studio CLI — Tinqs Blog</title>
|
|
<meta name="description" content="A single Go binary that gives AI agents full context about your machine, project, and services in 100ms. Screenshots, cloud vision, health checks — one install, every machine.">
|
|
<meta name="robots" content="index, follow">
|
|
<link rel="canonical" href="https://www.tinqs.com/blog/studio-cli">
|
|
|
|
<meta property="og:type" content="article">
|
|
<meta property="og:url" content="https://www.tinqs.com/blog/studio-cli">
|
|
<meta property="og:title" content="One Binary to Rule Them All: Our Studio CLI">
|
|
<meta property="og:description" content="One Go binary for machine identity, screenshots, cloud vision, and AI agent context.">
|
|
<meta property="og:image" content="https://www.tinqs.com/img/og-cover.jpg">
|
|
|
|
<meta name="twitter:card" content="summary_large_image">
|
|
<meta name="twitter:title" content="One Binary to Rule Them All: Our Studio CLI">
|
|
<meta name="twitter:description" content="One Go binary for machine identity, screenshots, cloud vision, and AI agent context.">
|
|
<meta name="twitter:image" content="https://www.tinqs.com/img/og-cover.jpg">
|
|
|
|
<script type="application/ld+json">
|
|
{
|
|
"@context": "https://schema.org",
|
|
"@type": "BlogPosting",
|
|
"headline": "One Binary to Rule Them All: Our Studio CLI",
|
|
"datePublished": "2026-05-18",
|
|
"author": {
|
|
"@type": "Person",
|
|
"name": "Ozan Bozkurt"
|
|
},
|
|
"publisher": {
|
|
"@type": "Organization",
|
|
"name": "Tinqs Limited",
|
|
"url": "https://www.tinqs.com"
|
|
},
|
|
"description": "A single Go binary that gives AI agents full context about your machine, project, and services in 100ms. Screenshots, cloud vision, health checks — one install, every machine."
|
|
}
|
|
</script>
|
|
|
|
<link rel="preconnect" href="https://fonts.googleapis.com">
|
|
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
|
|
<link href="https://fonts.googleapis.com/css2?family=Space+Grotesk:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500&family=Inter:wght@400;500;600;700&display=swap" rel="stylesheet">
|
|
|
|
<style>
|
|
/* ── Tinqs Studio brand — post styles ── */
|
|
|
|
:root {
|
|
/* Studio near-black base */
|
|
--c-bg: #0B0C0E;
|
|
--c-bg-raised: #15171A;
|
|
/* Foreground */
|
|
--c-fg: #ECEEF1;
|
|
--c-muted: #8A95A3;
|
|
/* Family accents */
|
|
--c-lime: #B6FF3C;
|
|
--c-violet: #7C5CFF;
|
|
/* Borders */
|
|
--c-border: rgba(255,255,255,.07);
|
|
--c-border-strong: rgba(255,255,255,.12);
|
|
}
|
|
|
|
*, *::before, *::after { box-sizing: border-box; }
|
|
|
|
html { background: var(--c-bg); }
|
|
|
|
body {
|
|
margin: 0;
|
|
padding: 0;
|
|
background: var(--c-bg);
|
|
color: var(--c-fg);
|
|
font-family: 'Inter', system-ui, -apple-system, sans-serif;
|
|
font-size: 16px;
|
|
line-height: 1.6;
|
|
-webkit-font-smoothing: antialiased;
|
|
}
|
|
|
|
/* ── Post container ── */
|
|
.post {
|
|
background: var(--c-bg);
|
|
max-width: 720px;
|
|
margin: 0 auto;
|
|
padding: 48px 24px 60px;
|
|
}
|
|
|
|
/* ── Back link ── */
|
|
.post__back {
|
|
color: var(--c-muted);
|
|
text-decoration: none;
|
|
font-size: 0.875rem;
|
|
display: inline-block;
|
|
margin-bottom: 24px;
|
|
transition: color 0.15s;
|
|
}
|
|
.post__back:hover { color: var(--c-lime); }
|
|
|
|
/* ── Gradient title — lime → violet ── */
|
|
.post__title {
|
|
font-family: 'Space Grotesk', system-ui, -apple-system, sans-serif;
|
|
background: linear-gradient(90deg, var(--c-lime), var(--c-violet));
|
|
-webkit-background-clip: text;
|
|
background-clip: text;
|
|
color: transparent;
|
|
font-weight: 700;
|
|
font-size: 2.2rem;
|
|
line-height: 1.2;
|
|
margin: 0 0 16px;
|
|
}
|
|
|
|
/* ── Date pill ── */
|
|
.post__date {
|
|
display: inline-block;
|
|
font-family: 'JetBrains Mono', ui-monospace, 'SF Mono', Consolas, monospace;
|
|
font-size: 0.72rem;
|
|
letter-spacing: 0.18em;
|
|
text-transform: uppercase;
|
|
color: var(--c-muted);
|
|
border: 1px solid var(--c-border);
|
|
border-radius: 999px;
|
|
padding: 4px 14px;
|
|
margin-bottom: 16px;
|
|
}
|
|
|
|
/* ── Lead ── */
|
|
.post__lead {
|
|
color: var(--c-muted);
|
|
font-size: 1.08rem;
|
|
line-height: 1.7;
|
|
}
|
|
|
|
/* ── Body ── */
|
|
.post__body { font-size: 1rem; line-height: 1.7; }
|
|
|
|
.post__body p { margin: 14px 0; }
|
|
|
|
.post__body h2 {
|
|
font-family: 'Space Grotesk', system-ui, -apple-system, sans-serif;
|
|
font-weight: 600;
|
|
font-size: 1.6rem;
|
|
margin: 54px 0 6px;
|
|
padding-left: 16px;
|
|
border-left: 4px solid var(--c-lime);
|
|
line-height: 1.3;
|
|
}
|
|
|
|
.post__body h3 {
|
|
font-family: 'Space Grotesk', system-ui, -apple-system, sans-serif;
|
|
font-weight: 500;
|
|
color: var(--c-violet);
|
|
font-size: 1.15rem;
|
|
margin: 30px 0 4px;
|
|
}
|
|
|
|
.post__body h4, .post__body h5, .post__body h6 {
|
|
margin: 20px 0 4px;
|
|
}
|
|
|
|
/* ── Inline code ── */
|
|
.post__body code {
|
|
font-family: 'JetBrains Mono', ui-monospace, 'SF Mono', Consolas, monospace;
|
|
font-size: 0.84em;
|
|
background: var(--c-bg-raised);
|
|
color: var(--c-lime);
|
|
padding: 2px 6px;
|
|
border-radius: 4px;
|
|
border: 1px solid var(--c-border);
|
|
}
|
|
|
|
/* ── Code blocks ── */
|
|
.post__body pre {
|
|
background: var(--c-bg);
|
|
border: 1px solid var(--c-border);
|
|
border-radius: 8px;
|
|
padding: 16px 18px;
|
|
overflow-x: auto;
|
|
margin: 14px 0;
|
|
font-family: 'JetBrains Mono', ui-monospace, 'SF Mono', Consolas, monospace;
|
|
font-size: 0.83rem;
|
|
line-height: 1.55;
|
|
color: var(--c-fg);
|
|
}
|
|
|
|
.post__body pre code {
|
|
background: transparent;
|
|
padding: 0;
|
|
border: none;
|
|
font-size: inherit;
|
|
color: inherit;
|
|
border-radius: 0;
|
|
}
|
|
|
|
/* ── Blockquote ── */
|
|
.post__body blockquote {
|
|
background: rgba(124, 92, 255, 0.06);
|
|
border: 1px solid rgba(124, 92, 255, 0.15);
|
|
border-left: 4px solid var(--c-violet);
|
|
border-radius: 0 8px 8px 0;
|
|
padding: 16px 18px;
|
|
margin: 18px 0;
|
|
color: var(--c-fg);
|
|
font-size: 0.94rem;
|
|
}
|
|
|
|
/* ── Links ── */
|
|
.post__body a { color: var(--c-lime); text-decoration: underline; text-underline-offset: 3px; }
|
|
.post__body a:hover { color: var(--c-violet); }
|
|
|
|
/* ── Strong ── */
|
|
.post__body strong { color: var(--c-lime); font-weight: 600; }
|
|
|
|
/* ── HR ── */
|
|
.post__body hr {
|
|
border: none;
|
|
border-top: 1px solid var(--c-border);
|
|
margin: 32px 0;
|
|
}
|
|
|
|
/* ── Figures ── */
|
|
.post__body figure { margin: 20px 0; }
|
|
.post__body figure img {
|
|
max-width: 100%;
|
|
border-radius: 12px;
|
|
border: 1px solid var(--c-border);
|
|
}
|
|
|
|
.post__body figcaption {
|
|
color: var(--c-muted);
|
|
font-size: 0.85rem;
|
|
margin-top: 6px;
|
|
}
|
|
|
|
/* ── Lists ── */
|
|
.post__body ul, .post__body ol { padding-left: 1.5em; margin: 10px 0; }
|
|
.post__body li { margin: 4px 0; }
|
|
|
|
/* ── Author ── */
|
|
.post__author {
|
|
display: flex;
|
|
align-items: center;
|
|
gap: 14px;
|
|
margin-top: 48px;
|
|
padding-top: 24px;
|
|
border-top: 1px solid var(--c-border);
|
|
}
|
|
|
|
.post__author-avatar {
|
|
width: 48px;
|
|
height: 48px;
|
|
border-radius: 50%;
|
|
background: var(--c-violet);
|
|
color: #fff;
|
|
display: flex;
|
|
align-items: center;
|
|
justify-content: center;
|
|
font-weight: 700;
|
|
font-size: 0.85rem;
|
|
flex-shrink: 0;
|
|
}
|
|
|
|
.post__author-info {
|
|
font-size: 0.85rem;
|
|
color: var(--c-muted);
|
|
line-height: 1.4;
|
|
}
|
|
|
|
.post__author-name {
|
|
color: var(--c-fg);
|
|
font-weight: 600;
|
|
}
|
|
</style>
|
|
</head>
|
|
<body>
|
|
|
|
<!-- POST -->
|
|
<article class="post">
|
|
<a href="/blog/" class="post__back">← All Posts</a>
|
|
<span class="post__date">18 May 2026</span>
|
|
<h1 class="post__title">One Binary to Rule Them All: Our Studio CLI</h1>
|
|
<p class="post__lead">Every AI agent session starts the same way: cold. The agent doesn't know what project this is, who's asking, what tools are available, or what happened yesterday. You spend the first five minutes re-explaining context.</p>
|
|
|
|
<div class="post__body">
|
|
<p>Our CLI solves this in 100ms. One command — <code>tinqs identity</code> — and the agent knows everything. The binary is 15MB, has zero runtime dependencies, and runs on every machine in the studio.</p>
|
|
<h2>The identity command (100ms)</h2>
|
|
<p>When an agent starts, the first thing it calls is <code>tinqs identity</code>. The output:</p>
|
|
<ul>
|
|
<li><strong>Soul file</strong> — the agent's persistent identity, values, operating principles</li>
|
|
<li><strong>Company context</strong> — team members, roles, what the company does</li>
|
|
<li><strong>Machine context</strong> — hostname, OS, which repos are cloned, what services are running</li>
|
|
<li><strong>Ecosystem</strong> — other repos and their purpose</li>
|
|
<li><strong>Service status</strong> — which URLs are live and reachable</li>
|
|
</ul>
|
|
<p>This data lives in markdown files in the docs repo. Any machine on the network can read it. The agent goes from blank to fully contextual in under a second.</p>
|
|
<p>This started as a convenience tool for humans. It became the single most important function in our stack. Every agent session — Cursor, Claude Code, Pi — starts with <code>tinqs identity</code>. Without it, every conversation begins with "let me explain the project." With it, the agent already knows.</p>
|
|
<h2>Screenshots and cloud vision</h2>
|
|
<p>The CLI can capture any window from outside the process. No in-game overlay, no rendering pipeline integration. OS-level capture — GDI+ on Windows, screencapture on Mac.</p>
|
|
<p>A <code>photo</code> command sends the screenshot to a cloud vision model. The agent says "take a photo of the game" and gets back: "The player character is standing near a half-built hut. Three palm trees to the left. The terrain has a visible seam between two biomes."</p>
|
|
<p>This is how you file bugs without typing. Look at the game, tell the agent what's wrong. It takes a screenshot, describes what it sees, and creates an issue with both the description and the image attached. Keyboard-free bug reporting.</p>
|
|
<h2>Health checks</h2>
|
|
<p><code>tinqs doctor</code> runs a comprehensive check:</p>
|
|
<ul>
|
|
<li>Is the git platform reachable and authenticated?</li>
|
|
<li>Is the game server running?</li>
|
|
<li>Are all expected repos cloned and on the right branch?</li>
|
|
<li>Are required tools installed at the right version?</li>
|
|
</ul>
|
|
<p>Output is a green/yellow/red table. Essential for unattended agent sessions — the agent verifies its environment before starting work. No "the build failed because port 3000 was already taken" at 3am.</p>
|
|
<h2>Why Go</h2>
|
|
<p>Go compiles to a single static binary. No Python virtualenvs, no Node.js version managers, no DLL hell on Windows. The same binary runs on a gaming PC, a designer's MacBook, and a CI runner in AWS.</p>
|
|
<p>Cross-compilation is trivial. We build Windows, Mac (arm64 + amd64), and Linux binaries from a single CI workflow. Push a tag, CI builds all three, uploads to S3. The binary is 15MB, starts in under 100ms, has zero runtime dependencies.</p>
|
|
<h2>What we learned</h2>
|
|
<p><strong>The CLI is the API for AI agents.</strong> What started as a human convenience tool became the primary interface for agents. Every session starts with <code>tinqs identity</code>. The agent's "hands and eyes" — screenshots, vision, health checks — are subcommands of the same binary.</p>
|
|
<p><strong>One binary beats ten scripts.</strong> Scripts rot. They have different shells, different PATH assumptions, different error handling. A compiled binary either works or it doesn't. It ships with dependencies baked in. It doesn't care if your Python is 3.9 or 3.12.</p>
|
|
<p><strong>Cloud vision is underrated for game dev.</strong> Sending a screenshot to a vision model sounds gimmicky. In practice, it's the fastest way to document visual bugs. "The tree is floating 2m above the terrain" is much faster to communicate when the AI is looking at the same screen.</p>
|
|
<p><strong>Agent cold starts are the real problem.</strong> Without the identity system, every session starts with the agent asking "what project is this?" With it, the agent knows everything in 100ms. That's the difference between an AI assistant and an AI team member.</p>
|
|
<hr>
|
|
<p><em>The CLI is part of <a href="https://tinqs.com" style="color: var(--c-lime);">Tinqs Studio</a>. Every time we find ourselves about to write a script that needs to work on multiple machines, we add a subcommand instead. One binary that makes the studio work — whether the operator is human or AI.</em></p>
|
|
|
|
</div>
|
|
|
|
<div class="post__author">
|
|
<div class="post__author-avatar">OB</div>
|
|
<div class="post__author-info">
|
|
<span class="post__author-name">Ozan Bozkurt</span><br>
|
|
CTO & Developer, Tinqs
|
|
</div>
|
|
</div>
|
|
</article>
|
|
|
|
</body>
|
|
</html>
|