# TM Code > TM Code is an Agent-First IDE for programming with AI agents. The agent writes code, shows diffs, opens live previews, and deploys — all from a chat-first interface. Available for macOS, Windows, and Linux. Built by Toque Media. This file follows the llmstxt.org convention. It points language models to clean, plain-text resources that describe the product without the JS-rendered SPA chrome. ## Quick start for language models - [Landing summary](https://code.toquemedia.net/index.md): one-page overview of what TM Code is, who it is for, supported platforms, and pricing tiers. - [Full documentation](https://code.toquemedia.net/llms-full.txt): every section concatenated as plain markdown (~1230 lines). ## Começar - [Bem-vindo](https://code.toquemedia.net/docs/bem-vindo.md): > Esta documentação cobre tudo o que precisas para usar o TM Code, do primeiro arranque às utilizações avançadas. Não assume conhecimento prévio do produto. - [O que é o TM Code](https://code.toquemedia.net/docs/1-o-que-e-o-tm-code.md): O TM Code é um **IDE Agent-First** — um ambiente de desenvolvimento onde a forma natural de trabalhar é **conversar com um agente de IA** que escreve código por - [Instalação e requisitos](https://code.toquemedia.net/docs/2-instalacao-e-requisitos.md): - **macOS** 10.15+ (universal: Intel + Apple Silicon) - [Primeiros passos](https://code.toquemedia.net/docs/3-primeiros-passos.md): Ao abrires o TM Code pela primeira vez vês o ecrã de login. Entras com **email + password**. Após o registo, é-te enviado um email de verificação (em português) ## Conceitos - [Conceitos fundamentais](https://code.toquemedia.net/docs/4-conceitos-fundamentais.md): O TM Code tem **5 vistas** principais. Mudas entre elas pela activity bar (esquerda) ou por atalhos: - [O ecrã principal](https://code.toquemedia.net/docs/5-o-ecra-principal.md): Por defeito, ao abrires um projecto, aterras em **Chat** com o **Preview** ao lado: ## Trabalhar com o agente - [Conversar com o agente](https://code.toquemedia.net/docs/6-conversar-com-o-agente.md): A barra de prompt (PromptBar) é onde compões a tua mensagem. Suporta: - [Comandos do agente (slash commands)](https://code.toquemedia.net/docs/7-comandos-do-agente-slash-commands.md): Escreves `/` no início da mensagem para abrir o menu de comandos. Tab/Enter para seleccionar. - [Capacidades do agente (tools)](https://code.toquemedia.net/docs/8-capacidades-do-agente-tools.md): O agente tem ferramentas para interagir com o teu projecto. Algumas são automáticas (read-only); outras pedem permissão antes de correr. - [Skills e hashtags](https://code.toquemedia.net/docs/9-skills-e-hashtags.md): Skills são **recipes em markdown** que o agente carrega para resolver problemas com qualidade conhecida. Há três níveis: - [Permissões e segurança](https://code.toquemedia.net/docs/10-permissoes-e-seguranca.md): 1. **Auto-aprovadas** — read_file, list_directory, search_files, glob, get_diagnostics, read_dev_server_logs, etc. Não interrompem o fluxo. - [Checkpoints e desfazer](https://code.toquemedia.net/docs/11-checkpoints-e-desfazer.md): **Cada acção que escreve ou apaga ficheiros** dispara um checkpoint automático. Ficam guardados em `~/.toquemedia-studio/sessions/{projecto}/checkpoints/`. ## Editor & ferramentas - [Editor manual](https://code.toquemedia.net/docs/12-editor-manual.md): Mesmo sendo agent-first, o editor manual está sempre acessível. Cmd/Ctrl+Shift+E abre a vista de editor. - [Preview e dev server](https://code.toquemedia.net/docs/13-preview-e-dev-server.md): O TM Code corre **um dev server por projecto**. Quando arranca: - [HTTP Client](https://code.toquemedia.net/docs/14-http-client.md): Para projectos backend e fullstack, o TM Code embute um cliente HTTP estilo Postman. - [Source control (Git)](https://code.toquemedia.net/docs/15-source-control-git.md): A vista de Source Control (atalho na activity bar) mostra: - [Debugger](https://code.toquemedia.net/docs/16-debugger.md): DAP (Debug Adapter Protocol) integrado. Funciona com Node.js, Chrome (via CDP), Python (com `debugpy`). - [Terminal integrado](https://code.toquemedia.net/docs/17-terminal-integrado.md): `Cmd/Ctrl+\`` para mostrar/esconder. Baseado em **xterm.js v6**. - [CMD mode](https://code.toquemedia.net/docs/18-cmd-mode.md): Modo alternativo, estilo REPL terminal. Para users que preferem uma interface mais densa, sem GUI gráfica. ## Avançado - [MCP — extensões do agente](https://code.toquemedia.net/docs/19-mcp-extensoes-do-agente.md): **MCP** (Model Context Protocol) é o standard para expor ferramentas a agentes IA. O TM Code suporta MCP servers locais (stdio) e remotos (HTTP). - [Settings](https://code.toquemedia.net/docs/20-settings.md): Atalho: `Cmd/Ctrl+,` ## Conta - [Planos e créditos](https://code.toquemedia.net/docs/21-planos-e-creditos.md): | Plano | Preço | Capacidade | Multimodal | - [Publicar (deploy)](https://code.toquemedia.net/docs/22-publicar-deploy.md): O botão **Publish** na title bar (ou `Cmd/Ctrl+Shift+D`) abre o modal de deploy. ## Referência - [Atalhos de teclado](https://code.toquemedia.net/docs/23-atalhos-de-teclado.md): Personalizáveis em Settings → Shortcuts. Defaults: - [Boas práticas](https://code.toquemedia.net/docs/24-boas-praticas.md): ❌ **Vago**: - [Resolução de problemas](https://code.toquemedia.net/docs/25-resolucao-de-problemas.md): 1. Vê o console (toggle no preview toolbar) - [Glossário](https://code.toquemedia.net/docs/26-glossario.md): - **Agente** — o modelo de IA que executa tools (não apenas chat) - [Suporte](https://code.toquemedia.net/docs/suporte.md): - **Email**: support@tmcode.app ## Resources - [Full documentation (single file)](https://code.toquemedia.net/llms-full.txt): every section concatenated as plain markdown. - [Changelog](https://code.toquemedia.net/changelog): release notes and product updates. - [Pricing](https://code.toquemedia.net/pricing): plan tiers, message budgets, and project seats. - [Download](https://code.toquemedia.net/download): macOS, Windows, and Linux installers. - [Features](https://code.toquemedia.net/features): chat-first agent, live preview, deploy. ## Optional - [Sitemap](https://code.toquemedia.net/sitemap.xml) - [robots.txt](https://code.toquemedia.net/robots.txt)