No Arch e derivadas, use o .AppImage: não há pacote no AUR.
bubblewrap é obrigatório, não sugerido. Sem ele o core recusa criar sessões de agente e o TYBA vira só um terminal.O .deb e o .rpm já o instalam. Com o AppImage, instale você: apt install bubblewrap (ou pacman -S bubblewrap no Arch).
Se a sua distribuição desabilita namespaces de usuário não-privilegiados — alguns kernels endurecidos, ou Debian com kernel.unprivileged_userns_clone=0 — as sessões de agente são recusadas com uma mensagem explicando o motivo. O sandbox nunca degrada em silêncio.
Baixe o .exe ou o .msi:
Arquivo
Quando usar
.exe
Para a maioria — clique e instale
.msi
Instalação gerenciada ou silenciosa
O instalador ainda não é assinado. O SmartScreen vai mostrar “O Windows protegeu seu computador”. Clique em Mais informações → Executar assim mesmo. A assinatura entra quando o certificado estiver no lugar.
A jaula de agente chegou ao Windows na 0.1.2. Como nas outras plataformas, ela é fail-closed: se não puder ser aplicada, a sessão é recusada em vez de rodar sem jaula.
A garantia de leitura no Windows é menor que no macOS e no Linux. A escrita é contida igual, mas a leitura é aberta por padrão, com uma lista de segredos conhecidos fechada. Na prática: o .env de outros projetos seus e outros repositórios da sua máquina são legíveis pelo agente.Leia Plataformas antes de decidir se isso serve para você.
Abra o TYBA e crie uma sessão de agente. Se ela sobe, os três pré-requisitos estão de pé: o agente está no PATH, o sandbox aplica, e o diretório é um repositório.Se algo falta, a mensagem diz qual — o TYBA falha explicando, não em silêncio.
O que acontece entre você descrever a tarefa e o código existir.
{"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":"pt-br/instalacao","slug":"/pt-br/instalacao","pageMetadata":{"title":"Instalação","description":"macOS, Linux e Windows — e o que você instala por fora: um agente e um repositório git.","href":"/pt-br/instalacao"},"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 e Windows — e o que você instala por fora: um agente e um repositório git.\"\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:[`Os binários da versão atual estão na `,_jsx(_components.a,{href:`https://www.tyba.dev/pt-br/download`,children:`página de download`}),`.`]}),`\n`,_jsxs(Tabs,{children:[_jsxs(Tab,{title:`macOS`,id:`macos`,children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`macOS 11 ou superior.`}),` Baixe o `,_jsx(_components.code,{children:`.dmg`}),` do seu chip — Apple Silicon ou Intel.`]}),_jsx(_components.p,{children:`Assinado e notarizado: abre sem aviso do Gatekeeper.`})]}),_jsxs(Tab,{title:`Linux`,id:`linux`,children:[_jsxs(_components.p,{children:[`Baixe o `,_jsx(_components.code,{children:`.deb`}),`, `,_jsx(_components.code,{children:`.rpm`}),` ou `,_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:[`No Arch e derivadas, use o `,_jsx(_components.code,{children:`.AppImage`}),`: não há pacote no AUR.`]}),_jsxs(Warning,{children:[_jsxs(_components.p,{children:[_jsxs(_components.strong,{children:[_jsx(_components.code,{children:`bubblewrap`}),` é obrigatório, não sugerido.`]}),` Sem ele o core recusa criar sessões de agente e o TYBA vira só um terminal.`]}),_jsxs(_components.p,{children:[`O `,_jsx(_components.code,{children:`.deb`}),` e o `,_jsx(_components.code,{children:`.rpm`}),` já o instalam. Com o AppImage, instale você: `,_jsx(_components.code,{children:`apt install bubblewrap`}),` (ou `,_jsx(_components.code,{children:`pacman -S bubblewrap`}),` no Arch).`]})]}),_jsxs(_components.p,{children:[`Se a sua distribuição desabilita namespaces de usuário não-privilegiados — alguns kernels endurecidos, ou Debian com `,_jsx(_components.code,{children:`kernel.unprivileged_userns_clone=0`}),` — as sessões de agente são recusadas com uma mensagem explicando o motivo. O sandbox nunca degrada em silêncio.`]})]}),_jsxs(Tab,{title:`Windows`,id:`windows`,children:[_jsxs(_components.p,{children:[`Baixe o `,_jsx(_components.code,{children:`.exe`}),` ou o `,_jsx(_components.code,{children:`.msi`}),`:`]}),_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Arquivo`}),_jsx(_components.th,{children:`Quando usar`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`.exe`})}),_jsx(_components.td,{children:`Para a maioria — clique e instale`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`.msi`})}),_jsx(_components.td,{children:`Instalação gerenciada ou silenciosa`})]})]})]}),_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`O instalador ainda não é assinado.`}),` O SmartScreen vai mostrar `,_jsx(_components.em,{children:`“O Windows protegeu seu computador”`}),`. Clique em `,_jsx(_components.strong,{children:`Mais informações → Executar assim mesmo`}),`. A assinatura entra quando o certificado estiver no lugar.`]})}),_jsx(_components.p,{children:`A jaula de agente chegou ao Windows na 0.1.2. Como nas outras plataformas, ela é fail-closed: se não puder ser aplicada, a sessão é recusada em vez de rodar sem jaula.`}),_jsxs(Warning,{children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`A garantia de leitura no Windows é menor que no macOS e no Linux.`}),` A escrita é contida igual, mas a leitura é aberta por padrão, com uma lista de segredos conhecidos fechada. Na prática: o `,_jsx(_components.code,{children:`.env`}),` de outros projetos seus e outros repositórios da sua máquina `,_jsx(_components.strong,{children:`são legíveis pelo agente`}),`.`]}),_jsxs(_components.p,{children:[`Leia `,_jsx(_components.a,{href:`/pt-br/seguranca/plataformas`,children:`Plataformas`}),` antes de decidir se isso serve para você.`]})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`instale-um-agente`,children:`Instale um agente`}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Os agentes não vêm junto.`}),` O TYBA orquestra o Claude Code e o Codex — ele não os embute.`]})}),`\n`,_jsx(_components.p,{children:`Instale pelo menos um:`}),`\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:[`O TYBA acha os dois pelo seu `,_jsx(_components.code,{children:`PATH`}),`. Se nenhum estiver instalado, você consegue usar o terminal, mas não criar sessão de agente.`]}),`\n`,_jsx(Heading,{level:`2`,id:`você-precisa-de-um-repositório-git`,children:`Você precisa de um repositório git`}),`\n`,_jsx(_components.p,{children:`Sessões de agente rodam em worktrees, e worktree é conceito de git. Uma pasta que não é repositório não serve.`}),`\n`,_jsx(Heading,{level:`2`,id:`confira`,children:`Confira`}),`\n`,_jsxs(_components.p,{children:[`Abra o TYBA e crie uma sessão de agente. Se ela sobe, os três pré-requisitos estão de pé: o agente está no `,_jsx(_components.code,{children:`PATH`}),`, o sandbox aplica, e o diretório é um repositório.`]}),`\n`,_jsx(_components.p,{children:`Se algo falta, a mensagem diz qual — o TYBA falha explicando, não em silêncio.`}),`\n`,_jsx(Heading,{level:`2`,id:`próximo`,children:`Próximo`}),`\n`,_jsx(Card,{title:`Primeira sessão`,icon:`arrow-right`,href:`/pt-br/primeira-sessao`,children:_jsx(_components.p,{children:`O que acontece entre você descrever a tarefa e o código existir.`})})]})}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":"Instalação","description":"macOS, Linux e Windows — e o que você instala por fora: um agente e um repositório git.","href":"/pt-br/instalacao"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Instale um agente","slug":"instale-um-agente","depth":2,"children":[]},{"title":"Você precisa de um repositório git","slug":"você-precisa-de-um-repositório-git","depth":2,"children":[]},{"title":"Confira","slug":"confira","depth":2,"children":[]},{"title":"Próximo","slug":"próximo","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"tyba-docs","siteName":"TYBA","title":"Instalação - TYBA","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"pt-BR":{"href":"/pt-br/instalacao","matchLevel":0},"en":{"href":"/en","matchLevel":3},"es":{"href":"/es","matchLevel":3}}},"lastModified":"2026-08-28T15:40:23.174Z","originalFileLocation":"pt-br/instalacao.mdx","locale":"pt-BR"},"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 e Windows — e o que você instala por fora: um agente e um repositório git.\">\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=\"Instalação - TYBA\">\u003cmeta data-mint-head property=\"og:description\" content=\"macOS, Linux e Windows — e o que você instala por fora: um agente e um repositório git.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"TYBA\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.tyba.dev/pt-br/instalacao\">\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=Come%C3%A7ando\u0026amp;title=Instala%C3%A7%C3%A3o\u0026amp;description=macOS%2C+Linux+e+Windows+%E2%80%94+e+o+que+voc%C3%AA+instala+por+fora%3A+um+agente+e+um+reposit%C3%B3rio+git.\u0026amp;theme=f7dc488ac44f9773437a2c98\u0026amp;signature=11b8998bddd07100bd334553a72a38b85f84259c81aff7b00c275bfee6b31c0a\">\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=\"Instalação - TYBA\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"macOS, Linux e Windows — e o que você instala por fora: um agente e um repositório git.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://tyba-docs.mintlify.site/_mintlify/api/og/v2?division=Come%C3%A7ando\u0026amp;title=Instala%C3%A7%C3%A3o\u0026amp;description=macOS%2C+Linux+e+Windows+%E2%80%94+e+o+que+voc%C3%AA+instala+por+fora%3A+um+agente+e+um+reposit%C3%B3rio+git.\u0026amp;theme=f7dc488ac44f9773437a2c98\u0026amp;signature=11b8998bddd07100bd334553a72a38b85f84259c81aff7b00c275bfee6b31c0a\">\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/pt-br/instalacao\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/pt-br/instalacao.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/pt-br/instalacao#webpage\",\"url\":\"https://docs.tyba.dev/pt-br/instalacao\",\"name\":\"Instalação\",\"description\":\"macOS, Linux e Windows — e o que você instala por fora: um agente e um repositório git.\",\"dateModified\":\"2026-08-28T15:40:23.174Z\",\"isPartOf\":{\"@id\":\"https://docs.tyba.dev#website\"},\"breadcrumb\":{\"@id\":\"https://docs.tyba.dev/pt-br/instalacao#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.tyba.dev/pt-br/instalacao#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Começando\",\"item\":\"https://docs.tyba.dev/pt-br\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Instalação\",\"item\":\"https://docs.tyba.dev/pt-br/instalacao\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.tyba.dev/pt-br/instalacao#article\",\"headline\":\"Instalação\",\"name\":\"Instalação\",\"description\":\"macOS, Linux e Windows — e o que você instala por fora: um agente e um repositório git.\",\"url\":\"https://docs.tyba.dev/pt-br/instalacao\",\"mainEntityOfPage\":{\"@id\":\"https://docs.tyba.dev/pt-br/instalacao#webpage\"},\"dateModified\":\"2026-08-28T15:40:23.174Z\",\"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":"/pt-br/instalacao.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"}},"groups":[{"group":"Começando","pages":[{"title":"TYBA","sidebarTitle":"Introdução","description":"Terminal opensource pra deixar vários agentes de IA trabalharem soltos sem você perder o controle — cada um isolado no sistema, e nada sai sem você aprovar.","href":"/pt-br"},{"title":"Instalação","href":"/pt-br/instalacao"},{"title":"Primeira sessão","description":"O que acontece entre você descrever a tarefa e o código existir.","href":"/pt-br/primeira-sessao"},{"title":"Tour da interface","href":"/pt-br/tour-da-interface"}]},{"group":"O terminal","pages":[{"title":"Usando o terminal","href":"/pt-br/terminal/usando-o-terminal"},{"title":"Busca no scrollback","href":"/pt-br/terminal/busca"},{"title":"Colar com segurança","href":"/pt-br/terminal/colar-com-seguranca"},{"title":"Shell integration","href":"/pt-br/terminal/shell-integration"},{"title":"A linha de comando do TYBA","href":"/pt-br/terminal/linha-de-comando"},{"title":"Blocos de comando","href":"/pt-br/terminal/blocos-de-comando"}]},{"group":"Interface","pages":[{"title":"Abas e workspaces","href":"/pt-br/interface/abas-e-workspaces"},{"title":"Split de painéis","href":"/pt-br/interface/split-de-paineis"},{"title":"Paleta de comandos","href":"/pt-br/interface/paleta-de-comandos"},{"title":"Atalhos de teclado","href":"/pt-br/interface/atalhos"},{"title":"Versão e diagnóstico","href":"/pt-br/interface/versao-e-diagnostico"}]},{"group":"Arquivos","pages":[{"title":"Painel de Arquivos","href":"/pt-br/arquivos/painel"},{"title":"Editar arquivos","href":"/pt-br/arquivos/edicao"},{"title":"Language server","href":"/pt-br/arquivos/language-server"},{"title":"Arquivos remotos","href":"/pt-br/arquivos/remoto"}]},{"group":"Temas","pages":[{"title":"Modo claro e escuro","href":"/pt-br/temas/modo-e-slots"},{"title":"Os temas","href":"/pt-br/temas/os-temas"},{"title":"Importar um tema","sidebarTitle":"Importar um tema","href":"/pt-br/temas/importar-tema"}]},{"group":"Sessões de agente","pages":[{"title":"Claude Code e Codex","sidebarTitle":"Claude Code e Codex","href":"/pt-br/agente/claude-code-e-codex"},{"title":"O composer","sidebarTitle":"O composer","href":"/pt-br/agente/composer"},{"title":"Subagentes","sidebarTitle":"Subagentes","href":"/pt-br/agente/subagentes"},{"title":"Agente iniciado no shell","href":"/pt-br/agente/agente-no-shell"},{"title":"Como o TYBA fala com o agente","sidebarTitle":"Como o TYBA fala com o agente","href":"/pt-br/agente/hooks"},{"title":"Notificações","sidebarTitle":"Notificações","href":"/pt-br/agente/notificacoes"},{"title":"Quadro e fila de agentes","sidebarTitle":"Quadro de agentes","href":"/pt-br/agente/quadro-de-agentes"},{"title":"Estatísticas de agentes","sidebarTitle":"Estatísticas","href":"/pt-br/agente/estatisticas"}]},{"group":"Worktrees e Git","pages":[{"title":"Worktrees","href":"/pt-br/git/worktrees"},{"title":"`.tyba/setup.sh`","sidebarTitle":".tyba/setup.sh","href":"/pt-br/git/setup-script"},{"title":"Branches","href":"/pt-br/git/branches"},{"title":"Resolver conflitos","href":"/pt-br/git/conflitos"}]},{"group":"Review e entrega","pages":[{"title":"Ler o diff","href":"/pt-br/review/ler-o-diff"},{"title":"Commit e push","href":"/pt-br/review/commit-e-push"},{"title":"Merge local","href":"/pt-br/review/merge-local"},{"title":"Pull requests","href":"/pt-br/review/pull-requests"},{"title":"Comentários do PR para o agente","href":"/pt-br/review/comentarios-para-o-agente"}]},{"group":"SSH","pages":[{"title":"Hosts e grupos","href":"/pt-br/ssh/hosts-e-grupos"},{"title":"Persistência da sessão","sidebarTitle":"Persistência","href":"/pt-br/ssh/persistencia"},{"title":"Broadcast","href":"/pt-br/ssh/broadcast"},{"title":"Túneis","href":"/pt-br/ssh/tuneis"},{"title":"Agente via SSH: o que você perde","sidebarTitle":"Agente via SSH","href":"/pt-br/ssh/agente-via-ssh"}]},{"group":"Docker","pages":[{"title":"Containers","href":"/pt-br/docker/containers"},{"title":"Docker remoto","href":"/pt-br/docker/docker-remoto"}]},{"group":"Segurança","pages":[{"title":"Classificação de risco","href":"/pt-br/seguranca/classificacao-de-risco"},{"title":"Plataformas","href":"/pt-br/seguranca/plataformas"}]},{"group":"Referência","pages":[{"title":"Configuração do usuário","sidebarTitle":"~/.tyba/config.toml","href":"/pt-br/configuracao/usuario"},{"title":"Configuração do repositório","sidebarTitle":".tyba/config.toml","href":"/pt-br/configuracao/repositorio"}]}]},{"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"}},"pages":[{"title":"en","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"}},"pages":[{"title":"es","href":"/es"}]}]},"basePath":"","title":"Instalação - TYBA","buildId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","deploymentId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","dynamics":[],"chunks":[]}
