On Arch and derivatives, use the .AppImage: there is no AUR package.
bubblewrap is a hard dependency, not a suggestion. Without it the core refuses to create agent sessions and TYBA is just a terminal.The .deb and the .rpm pull it in for you. With the AppImage, install it yourself: apt install bubblewrap (or pacman -S bubblewrap on Arch).
If your distro ships unprivileged user namespaces disabled — some hardened kernels, or Debian with kernel.unprivileged_userns_clone=0 — agent sessions are refused with a message explaining why. The sandbox never degrades silently.
Download the .exe or the .msi:
File
When to use it
.exe
For most people — click and install
.msi
Managed or silent installs
The installer is not signed yet. SmartScreen will show “Windows protected your PC”. Click More info → Run anyway. Signing lands once the certificate is in place.
The agent jail reached Windows in 0.1.2. Like on the other platforms, it is fail-closed: if it cannot be applied, the session is refused instead of running unjailed.
The read guarantee on Windows is weaker than on macOS and Linux. Writes are contained the same way, but reads are allow-by-default, with a deny list of known secrets. In practice: the .env files of your other projects and other repositories on your machine are readable by the agent.Read Platforms before deciding whether that works for you.
Open TYBA and create an agent session. If it comes up, all three prerequisites are in place: the agent is on your PATH, the sandbox applies, and the directory is a repository.If something is missing, the message says which — TYBA fails with an explanation, not in silence.
What happens between you describing the task and the code existing.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"TYBA","colors":{"primary":"#4f8a2b","light":"#7cc544","dark":"#7cc544"},"logo":{"light":"https://mintcdn.com/tyba-docs/u7AuxMYGkYmrvwlI/images/logo-light.svg?fit=max\u0026auto=format\u0026n=u7AuxMYGkYmrvwlI\u0026q=85\u0026s=513a50d5522923cbb6d5ddc0fc3c7498","dark":"https://mintcdn.com/tyba-docs/u7AuxMYGkYmrvwlI/images/logo-dark.svg?fit=max\u0026auto=format\u0026n=u7AuxMYGkYmrvwlI\u0026q=85\u0026s=59e9b2ffe99b3af181e73955d0475374","href":"https://www.tyba.dev"},"favicon":"https://mintcdn.com/tyba-docs/u7AuxMYGkYmrvwlI/images/favicon.png?fit=max\u0026auto=format\u0026n=u7AuxMYGkYmrvwlI\u0026q=85\u0026s=7f87a088d998c6a9b9b001c46429cbd1","navbar":{"links":[{"href":"https://github.com/tybadev/tyba-terminal","label":"GitHub"}],"primary":{"type":"button","label":"Download","href":"https://www.tyba.dev/pt-br/download"}},"footer":{"socials":{"github":"https://github.com/tybadev/tyba-terminal","website":"https://www.tyba.dev"}},"styling":{"latex":false},"navigation":{"languages":[{"language":"pt-BR","default":true,"navbar":{"links":[{"href":"https://github.com/tybadev/tyba-terminal","label":"GitHub"}],"primary":{"type":"button","label":"Download","href":"https://www.tyba.dev/pt-br/download"}},"href":"pt-br"},{"language":"en","navbar":{"links":[{"href":"https://github.com/tybadev/tyba-terminal","label":"GitHub"}],"primary":{"type":"button","label":"Download","href":"https://www.tyba.dev/en/download"}},"href":"en"},{"language":"es","navbar":{"links":[{"href":"https://github.com/tybadev/tyba-terminal","label":"GitHub"}],"primary":{"type":"button","label":"Download","href":"https://www.tyba.dev/download"}},"href":"es"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"tyba-docs","hasAudioNarration":false,"actualSubdomain":"tyba-docs","customDomains":["docs.tyba.dev"],"gitSource":{"type":"github","owner":"tybadev","repo":"tyba-terminal","deployBranch":"main","contentDirectory":"docs-site","isPrivate":false,"mountPath":"","label":""},"entitlements":{},"buildId":"6aa8808a0a4a2cec3d133a23","clientVersion":"0.0.4111","searchFilterCounts":[{"language":"en","tag":"Agent sessions","count":8},{"language":"es","tag":"Sesiones de agente","count":8},{"language":"pt-BR","tag":"Sessões de agente","count":8},{"language":"en","tag":"The terminal","count":6},{"language":"es","tag":"La terminal","count":6},{"language":"pt-BR","tag":"O terminal","count":6},{"language":"en","tag":"Interface","count":5},{"language":"en","tag":"Review and delivery","count":5},{"language":"en","tag":"SSH","count":5},{"language":"es","tag":"Interfaz","count":5},{"language":"es","tag":"Review y entrega","count":5},{"language":"es","tag":"SSH","count":5},{"language":"pt-BR","tag":"Interface","count":5},{"language":"pt-BR","tag":"Review e entrega","count":5},{"language":"pt-BR","tag":"SSH","count":5},{"language":"en","tag":"Files","count":4},{"language":"en","tag":"Getting started","count":4},{"language":"en","tag":"Worktrees and Git","count":4},{"language":"es","tag":"Archivos","count":4},{"language":"es","tag":"Worktrees y Git","count":4},{"language":"es","tag":"Empezando","count":4},{"language":"pt-BR","tag":"Arquivos","count":4},{"language":"pt-BR","tag":"Worktrees e Git","count":4},{"language":"pt-BR","tag":"Começando","count":4},{"language":"en","tag":"Themes","count":3},{"language":"es","tag":"Temas","count":3},{"language":"pt-BR","tag":"Temas","count":3},{"language":"en","tag":"Docker","count":2},{"language":"es","tag":"Docker","count":2},{"language":"pt-BR","tag":"Referência","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"en/installation","slug":"/en/installation","pageMetadata":{"title":"Installation","description":"macOS, Linux and Windows — and what you install yourself: an agent and a git repo.","href":"/en/installation"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"macOS, Linux and Windows — and what you install yourself: an agent and a git repo.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,em:`em`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Card,CodeBlock,Heading,Tab,Table,Tabs,Warning}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Tab)_missingMdxReference(`Tab`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tabs)_missingMdxReference(`Tabs`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`The binaries for the current version are on the `,_jsx(_components.a,{href:`https://www.tyba.dev/en/download`,children:`download page`}),`.`]}),`\n`,_jsxs(Tabs,{children:[_jsxs(Tab,{title:`macOS`,id:`macos`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`macOS 11 or later.`}),` Download the `,_jsx(_components.code,{children:`.dmg`}),` for your chip — Apple Silicon or Intel.`]}),_jsx(_components.p,{children:`Signed and notarized: it opens without a Gatekeeper warning.`})]}),_jsxs(Tab,{title:`Linux`,id:`linux`,children:[_jsxs(_components.p,{children:[`Download the `,_jsx(_components.code,{children:`.deb`}),`, `,_jsx(_components.code,{children:`.rpm`}),` or `,_jsx(_components.code,{children:`.AppImage`}),`:`]}),_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`sudo`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` apt`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` install`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` ./Tyba_0.6.0_amd64.deb`}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` # Debian / Ubuntu`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`sudo`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` dnf`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` install`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` ./Tyba-0.6.0-1.x86_64.rpm`}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` # Fedora`})]}),`\n`]})})}),_jsxs(_components.p,{children:[`On Arch and derivatives, use the `,_jsx(_components.code,{children:`.AppImage`}),`: there is no AUR package.`]}),_jsxs(Warning,{children:[_jsxs(_components.p,{children:[_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`bubblewrap`}),` is a hard dependency, not a suggestion.`]}),` Without it the core refuses to create agent sessions and TYBA is just a terminal.`]}),_jsxs(_components.p,{children:[`The `,_jsx(_components.code,{children:`.deb`}),` and the `,_jsx(_components.code,{children:`.rpm`}),` pull it in for you. With the AppImage, install it yourself: `,_jsx(_components.code,{children:`apt install bubblewrap`}),` (or `,_jsx(_components.code,{children:`pacman -S bubblewrap`}),` on Arch).`]})]}),_jsxs(_components.p,{children:[`If your distro ships unprivileged user namespaces disabled — some hardened kernels, or Debian with `,_jsx(_components.code,{children:`kernel.unprivileged_userns_clone=0`}),` — agent sessions are refused with a message explaining why. The sandbox never degrades silently.`]})]}),_jsxs(Tab,{title:`Windows`,id:`windows`,children:[_jsxs(_components.p,{children:[`Download the `,_jsx(_components.code,{children:`.exe`}),` or the `,_jsx(_components.code,{children:`.msi`}),`:`]}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`File`}),_jsx(_components.th,{children:`When to use it`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`.exe`})}),_jsx(_components.td,{children:`For most people — click and install`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`.msi`})}),_jsx(_components.td,{children:`Managed or silent installs`})]})]})]}),_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`The installer is not signed yet.`}),` SmartScreen will show `,_jsx(_components.em,{children:`“Windows protected your PC”`}),`. Click `,_jsx(_components.strong,{children:`More info → Run anyway`}),`. Signing lands once the certificate is in place.`]})}),_jsx(_components.p,{children:`The agent jail reached Windows in 0.1.2. Like on the other platforms, it is fail-closed: if it cannot be applied, the session is refused instead of running unjailed.`}),_jsxs(Warning,{children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`The read guarantee on Windows is weaker than on macOS and Linux.`}),` Writes are contained the same way, but reads are allow-by-default, with a deny list of known secrets. In practice: the `,_jsx(_components.code,{children:`.env`}),` files of your other projects and other repositories on your machine `,_jsx(_components.strong,{children:`are readable by the agent`}),`.`]}),_jsxs(_components.p,{children:[`Read `,_jsx(_components.a,{href:`/en/security/platforms`,children:`Platforms`}),` before deciding whether that works for you.`]})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`install-an-agent`,children:`Install an agent`}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Agents are not bundled.`}),` TYBA orchestrates Claude Code and Codex — it does not embed them.`]})}),`\n`,_jsx(_components.p,{children:`Install at least one:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`https://claude.com/claude-code`,children:`Claude Code`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`https://developers.openai.com/codex/cli`,children:`Codex`})}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`TYBA picks both up from your `,_jsx(_components.code,{children:`PATH`}),`. If neither is installed, you can still use the terminal, but not create an agent session.`]}),`\n`,_jsx(Heading,{level:`2`,id:`you-need-a-git-repository`,children:`You need a git repository`}),`\n`,_jsx(_components.p,{children:`Agent sessions run in worktrees, and a worktree is a git concept. A folder that isn’t a repository won’t do.`}),`\n`,_jsx(Heading,{level:`2`,id:`check-it`,children:`Check it`}),`\n`,_jsxs(_components.p,{children:[`Open TYBA and create an agent session. If it comes up, all three prerequisites are in place: the agent is on your `,_jsx(_components.code,{children:`PATH`}),`, the sandbox applies, and the directory is a repository.`]}),`\n`,_jsx(_components.p,{children:`If something is missing, the message says which — TYBA fails with an explanation, not in silence.`}),`\n`,_jsx(Heading,{level:`2`,id:`next`,children:`Next`}),`\n`,_jsx(Card,{title:`First session`,icon:`arrow-right`,href:`/en/first-session`,children:_jsx(_components.p,{children:`What happens between you describing the task and the code existing.`})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Installation","description":"macOS, Linux and Windows — and what you install yourself: an agent and a git repo.","href":"/en/installation"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Install an agent","slug":"install-an-agent","depth":2,"children":[]},{"title":"You need a git repository","slug":"you-need-a-git-repository","depth":2,"children":[]},{"title":"Check it","slug":"check-it","depth":2,"children":[]},{"title":"Next","slug":"next","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"tyba-docs","siteName":"TYBA","title":"Installation - TYBA","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"pt-BR":{"href":"/pt-br","matchLevel":3},"en":{"href":"/en/installation","matchLevel":0},"es":{"href":"/es","matchLevel":3}}},"lastModified":"2026-08-28T15:40:24.711Z","originalFileLocation":"en/installation.mdx","locale":"en"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"macOS, Linux and Windows — and what you install yourself: an agent and a git repo.\">\u003cmeta data-mint-head name=\"application-name\" content=\"TYBA\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/tyba-docs/h1rulr6_B2kUVCCk/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/tyba-docs/h1rulr6_B2kUVCCk/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/tyba-docs/h1rulr6_B2kUVCCk/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/tyba-docs/h1rulr6_B2kUVCCk/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/tyba-docs/h1rulr6_B2kUVCCk/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/tyba-docs/h1rulr6_B2kUVCCk/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/tyba-docs/h1rulr6_B2kUVCCk/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/tyba-docs/h1rulr6_B2kUVCCk/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/tyba-docs/h1rulr6_B2kUVCCk/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Installation - TYBA\">\u003cmeta data-mint-head property=\"og:description\" content=\"macOS, Linux and Windows — and what you install yourself: an agent and a git repo.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"TYBA\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.tyba.dev/en/installation\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://tyba-docs.mintlify.site/_mintlify/api/og/v2?division=Getting+started\u0026amp;title=Installation\u0026amp;description=macOS%2C+Linux+and+Windows+%E2%80%94+and+what+you+install+yourself%3A+an+agent+and+a+git+repo.\u0026amp;theme=f7dc488ac44f9773437a2c98\u0026amp;signature=7cf911028aae8c74c5255c0097094cd31becc1c7d0ec84633854b75db3c9a00d\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Installation - TYBA\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"macOS, Linux and Windows — and what you install yourself: an agent and a git repo.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://tyba-docs.mintlify.site/_mintlify/api/og/v2?division=Getting+started\u0026amp;title=Installation\u0026amp;description=macOS%2C+Linux+and+Windows+%E2%80%94+and+what+you+install+yourself%3A+an+agent+and+a+git+repo.\u0026amp;theme=f7dc488ac44f9773437a2c98\u0026amp;signature=7cf911028aae8c74c5255c0097094cd31becc1c7d0ec84633854b75db3c9a00d\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/tyba-docs/h1rulr6_B2kUVCCk/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"TYBA\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#4f8a2b\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.tyba.dev/en/installation\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/en/installation.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.tyba.dev/#organization\",\"name\":\"TYBA\",\"url\":\"https://docs.tyba.dev\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/tyba-docs/u7AuxMYGkYmrvwlI/images/logo-light.svg?fit=max\u0026auto=format\u0026n=u7AuxMYGkYmrvwlI\u0026q=85\u0026s=513a50d5522923cbb6d5ddc0fc3c7498\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.tyba.dev#website\",\"name\":\"TYBA\",\"url\":\"https://docs.tyba.dev\",\"publisher\":{\"@id\":\"https://docs.tyba.dev/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.tyba.dev/en/installation#webpage\",\"url\":\"https://docs.tyba.dev/en/installation\",\"name\":\"Installation\",\"description\":\"macOS, Linux and Windows — and what you install yourself: an agent and a git repo.\",\"dateModified\":\"2026-08-28T15:40:24.711Z\",\"isPartOf\":{\"@id\":\"https://docs.tyba.dev#website\"},\"breadcrumb\":{\"@id\":\"https://docs.tyba.dev/en/installation#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.tyba.dev/en/installation#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Getting started\",\"item\":\"https://docs.tyba.dev/en\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Installation\",\"item\":\"https://docs.tyba.dev/en/installation\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.tyba.dev/en/installation#article\",\"headline\":\"Installation\",\"name\":\"Installation\",\"description\":\"macOS, Linux and Windows — and what you install yourself: an agent and a git repo.\",\"url\":\"https://docs.tyba.dev/en/installation\",\"mainEntityOfPage\":{\"@id\":\"https://docs.tyba.dev/en/installation#webpage\"},\"dateModified\":\"2026-08-28T15:40:24.711Z\",\"publisher\":{\"@id\":\"https://docs.tyba.dev/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.tyba.dev#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"TYBA\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"TYBA\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/en/installation.md","siteName":"TYBA","nav":{"global":null,"languages":[{"language":"pt-BR","default":true,"navbar":{"links":[{"href":"https://github.com/tybadev/tyba-terminal","label":"GitHub"}],"primary":{"type":"button","label":"Download","href":"https://www.tyba.dev/pt-br/download"}},"pages":[{"title":"pt-BR","href":"/pt-br"}]},{"language":"en","navbar":{"links":[{"href":"https://github.com/tybadev/tyba-terminal","label":"GitHub"}],"primary":{"type":"button","label":"Download","href":"https://www.tyba.dev/en/download"}},"groups":[{"group":"Getting started","pages":[{"title":"TYBA","sidebarTitle":"Introduction","description":"Open-source terminal to let many AI agents work loose without losing control — each isolated in the OS, and nothing ships without your approval.","href":"/en"},{"title":"Installation","href":"/en/installation"},{"title":"First session","description":"What happens between you describing the task and the code existing.","href":"/en/first-session"},{"title":"Interface tour","href":"/en/interface-tour"}]},{"group":"The terminal","pages":[{"title":"Using the terminal","href":"/en/terminal/using-the-terminal"},{"title":"Scrollback search","href":"/en/terminal/search"},{"title":"Safe paste","href":"/en/terminal/safe-paste"},{"title":"Shell integration","href":"/en/terminal/shell-integration"},{"title":"The TYBA command line","href":"/en/terminal/command-line"},{"title":"Command blocks","href":"/en/terminal/command-blocks"}]},{"group":"Interface","pages":[{"title":"Tabs and workspaces","href":"/en/interface/tabs-and-workspaces"},{"title":"Split panes","href":"/en/interface/split-panes"},{"title":"Command palette","href":"/en/interface/command-palette"},{"title":"Keyboard shortcuts","href":"/en/interface/shortcuts"},{"title":"Version and diagnostics","href":"/en/interface/version-and-diagnostics"}]},{"group":"Files","pages":[{"title":"Files panel","href":"/en/files/panel"},{"title":"Editing files","href":"/en/files/editing"},{"title":"Language server","href":"/en/files/language-server"},{"title":"Remote files","href":"/en/files/remote"}]},{"group":"Themes","pages":[{"title":"Light and dark mode","href":"/en/themes/light-and-dark"},{"title":"The themes","href":"/en/themes/the-themes"},{"title":"Import a theme","sidebarTitle":"Import a theme","href":"/en/themes/import-a-theme"}]},{"group":"Agent sessions","pages":[{"title":"Claude Code and Codex","sidebarTitle":"Claude Code and Codex","href":"/en/agent/claude-code-and-codex"},{"title":"The composer","sidebarTitle":"The composer","href":"/en/agent/composer"},{"title":"Subagents","sidebarTitle":"Subagents","href":"/en/agent/subagents"},{"title":"Agent started in a shell","href":"/en/agent/agent-in-a-shell"},{"title":"How TYBA talks to the agent","sidebarTitle":"How TYBA talks to the agent","href":"/en/agent/hooks"},{"title":"Notifications","sidebarTitle":"Notifications","href":"/en/agent/notifications"},{"title":"Agents board and queue","sidebarTitle":"Agents board","href":"/en/agent/agents-board"},{"title":"Agent stats","sidebarTitle":"Stats","href":"/en/agent/statistics"}]},{"group":"Worktrees and Git","pages":[{"title":"Worktrees","href":"/en/git/worktrees"},{"title":"`.tyba/setup.sh`","sidebarTitle":".tyba/setup.sh","href":"/en/git/setup-script"},{"title":"Branches","href":"/en/git/branches"},{"title":"Resolving conflicts","href":"/en/git/conflicts"}]},{"group":"Review and delivery","pages":[{"title":"Reading the diff","href":"/en/review/reading-the-diff"},{"title":"Commit and push","href":"/en/review/commit-and-push"},{"title":"Local merge","href":"/en/review/local-merge"},{"title":"Pull requests","href":"/en/review/pull-requests"},{"title":"PR comments to the agent","href":"/en/review/pr-comments-to-agent"}]},{"group":"SSH","pages":[{"title":"Hosts and groups","href":"/en/ssh/hosts-and-groups"},{"title":"Session persistence","sidebarTitle":"Persistence","href":"/en/ssh/persistence"},{"title":"Broadcast","href":"/en/ssh/broadcast"},{"title":"Tunnels","href":"/en/ssh/tunnels"},{"title":"Agent over SSH: what you lose","sidebarTitle":"Agent over SSH","href":"/en/ssh/agent-over-ssh"}]},{"group":"Docker","pages":[{"title":"Containers","href":"/en/docker/containers"},{"title":"Remote Docker","href":"/en/docker/remote-docker"}]},{"group":"Security","pages":[{"title":"Risk classification","href":"/en/security/risk-classification"},{"title":"Platforms","href":"/en/security/platforms"}]},{"group":"Reference","pages":[{"title":"User configuration","sidebarTitle":"~/.tyba/config.toml","href":"/en/reference/user-config"},{"title":"Repository configuration","sidebarTitle":".tyba/config.toml","href":"/en/reference/repo-config"}]}]},{"language":"es","navbar":{"links":[{"href":"https://github.com/tybadev/tyba-terminal","label":"GitHub"}],"primary":{"type":"button","label":"Download","href":"https://www.tyba.dev/download"}},"pages":[{"title":"es","href":"/es"}]}]},"basePath":"","title":"Installation - TYBA","buildId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","deploymentId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","dynamics":[],"chunks":[]}
