index.html

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Get started | Install your AI agent workplace | PassionCode.ai</title><meta name="description" content="Set up PassionCode.ai with one command, or one prompt for Claude Code or Codex: the tools, their MCP servers and the skills. The same command checks and repairs a setup you already have. Free and open source.">
  <link rel="canonical" href="https://passioncode.ai/start/">
  <link rel="alternate" hreflang="en" href="https://passioncode.ai/start/"><link rel="alternate" hreflang="ru" href="https://passioncode.ai/ru/start/"><link rel="alternate" hreflang="de" href="https://passioncode.ai/de/start/"><link rel="alternate" hreflang="fr" href="https://passioncode.ai/fr/start/"><link rel="alternate" hreflang="pl" href="https://passioncode.ai/pl/start/"><link rel="alternate" hreflang="ko" href="https://passioncode.ai/ko/start/"><link rel="alternate" hreflang="es" href="https://passioncode.ai/es/start/"><link rel="alternate" hreflang="pt-BR" href="https://passioncode.ai/pt-br/start/"><link rel="alternate" hreflang="zh-Hans" href="https://passioncode.ai/zh-hans/start/"><link rel="alternate" hreflang="ja" href="https://passioncode.ai/ja/start/"><link rel="alternate" hreflang="x-default" href="https://passioncode.ai/start/">
  <meta name="robots" content="index, follow"><meta name="theme-color" content="#0a070d">
  <meta property="og:type" content="article"><meta property="og:site_name" content="PassionCode.ai"><meta property="og:locale" content="en_US"><meta property="og:locale:alternate" content="ru_RU"><meta property="og:locale:alternate" content="de_DE"><meta property="og:locale:alternate" content="fr_FR"><meta property="og:locale:alternate" content="pl_PL"><meta property="og:locale:alternate" content="ko_KR"><meta property="og:locale:alternate" content="es_ES"><meta property="og:locale:alternate" content="pt_BR"><meta property="og:locale:alternate" content="zh_CN"><meta property="og:locale:alternate" content="ja_JP">
  <meta property="og:title" content="Get started with PassionCode.ai"><meta property="og:description" content="From an empty computer to your first agents at work: one command, or five steps by hand. Free and open source.">
  <meta property="og:url" content="https://passioncode.ai/start/">
  <meta property="og:image" content="https://passioncode.ai/assets/passioncode-social-card.png">
  <meta property="og:image:width" content="1200"><meta property="og:image:height" content="630">
  <meta name="twitter:card" content="summary_large_image"><meta name="twitter:image" content="https://passioncode.ai/assets/passioncode-social-card.png">
  <link rel="icon" type="image/svg+xml" href="/assets/passioncode-mark.svg">
  <link rel="icon" type="image/png" sizes="64x64" href="/assets/favicon-64.png">
  <link rel="apple-touch-icon" sizes="256x256" href="/assets/icon-256.png">
  <link rel="stylesheet" href="/design-system/tokens.css"><link rel="stylesheet" href="/styles.css">
  <script type="module" src="/assets/site.js"></script>
  <script type="application/ld+json">{
  "@context": "https://schema.org",
  "@type": "HowTo",
  "name": "Set up an AI agent workplace with PassionCode.ai",
  "description": "Run one command, npx @passioncode-ai/passioncode@latest setup, or let your coding agent run it; then create a Fabric agent or adapt an existing project, see it in Fabric Dashboards and add the next agent to the same project.",
  "totalTime": "PT20M",
  "tool": [{ "@type": "HowToTool", "name": "Claude Code or Codex" }, { "@type": "HowToTool", "name": "Node.js 18 or later" }],
  "step": [
    { "@type": "HowToStep", "position": 1, "name": "Set up", "text": "Run npx @passioncode-ai/passioncode@latest setup, or paste the setup prompt into your coding agent, then restart the agent.", "url": "https://passioncode.ai/start/#setup" },
    { "@type": "HowToStep", "position": 2, "name": "Create or adapt an agent", "text": "Ask your coding agent to create a Fabric agent, or to adapt an existing project to Fabric.", "url": "https://passioncode.ai/start/#build" },
    { "@type": "HowToStep", "position": 3, "name": "Run it and see it", "text": "Open Fabric Dashboards: the one command installs it on macOS and connects it to your coding agent over MCP.", "url": "https://passioncode.ai/start/#run" },
    { "@type": "HowToStep", "position": 4, "name": "Add the next agent to the same project", "text": "Create a second agent for the next job and give it the same Fabric project, so both share its board, memory and hand-offs.", "url": "https://passioncode.ai/start/#family" }
  ]
}</script>
</head>
<body class="story-site"><a class="skip-link" href="#main">Skip to content</a>
<header class="site-header">
 <a class="brand" href="/" aria-label="PassionCode.ai home"><img src="/assets/passioncode-mark.svg" width="40" height="40" alt=""><span>PassionCode<span class="brand-dot">.ai</span></span></a>
 <nav aria-label="Primary navigation"><a href="/vision/">Vision</a><a href="/start/">For you</a><a href="/business/">For organizations</a><a href="/#products">The tools</a><a href="/#about">About</a></nav>
 <div class="header-actions"><details class="lang-switch lang-menu"><summary aria-label="Language: English"><span lang="en">English</span></summary><ul><li><a href="/ru/start/" hreflang="ru" lang="ru">Русский</a></li><li><a href="/de/start/" hreflang="de" lang="de">Deutsch</a></li><li><a href="/fr/start/" hreflang="fr" lang="fr">Français</a></li><li><a href="/pl/start/" hreflang="pl" lang="pl">Polski</a></li><li><a href="/ko/start/" hreflang="ko" lang="ko">한국어</a></li><li><a href="/es/start/" hreflang="es" lang="es">Español</a></li><li><a href="/pt-br/start/" hreflang="pt-BR" lang="pt-BR">Português (Brasil)</a></li><li><a href="/zh-hans/start/" hreflang="zh-Hans" lang="zh-Hans">简体中文</a></li><li><a href="/ja/start/" hreflang="ja" lang="ja">日本語</a></li></ul></details><a class="header-link header-download" href="/start/#setup">Set up <span aria-hidden="true">↓</span></a></div>
</header>
<main id="main">
<section class="hero page-hero" aria-labelledby="hero-title">
 <div class="hero-copy">
  <p class="eyebrow"><span></span> Get started · free and open source</p>
  <h1 id="hero-title">From an empty computer to <em>your first agent</em></h1>
  <p class="hero-body">Build agents that keep working and know what the others did. One command sets up the tools, and the same command checks them later</p>
  <p class="hero-caption"><span class="status-dot" aria-hidden="true"></span> Needs Node.js 18+ and Claude Code or Codex <span>Fabric needs Docker and the Supabase CLI on every system</span></p>
 </div>
 <nav class="page-toc" aria-label="On this page"><a href="#setup"><span>→</span> One command</a><a href="#build"><span>01</span> Create or adapt an agent</a><a href="#run"><span>02</span> Run it and see it</a><a href="#family"><span>03</span> Add the next agent</a><a href="#contribute"><span>+</span> Contribute</a></nav>
</section>

<section class="section setup-section" id="setup" aria-labelledby="setup-title">
 <span id="launcher" class="legacy-anchor" aria-hidden="true"></span>
 <div class="section-heading story-heading"><p class="section-number">ONE COMMAND</p><h2 id="setup-title">Set up everything,<br>or check what you have</h2><p>On macOS, one command installs the tools you choose from their signed releases, connects their MCP servers to Claude Code, Codex, Gemini CLI and Kimi Code, and adds the skills. On Windows and Linux, download the apps from their pages, then run the same command for the skills and the MCP servers. On a computer that is already set up, the same command checks everything, repairs what is wrong and shows what changed.</p></div>
 <div class="setup-pair">
 <div class="request-card" id="setup-command">
  <h3>Run it yourself</h3>
  <pre class="copyable"><code>npx @passioncode-ai/passioncode@latest setup</code></pre>
  <p class="step-meta">Needs Node.js 18+ · it installs nothing whose signature, checksum or notarization fails · restart your coding agent afterwards · to check without changing anything:</p>
  <pre class="copyable"><code>npx @passioncode-ai/passioncode@latest doctor</code></pre>
 </div>
 <div class="request-card agent-request" id="setup-agent">
  <h3>Or let your coding agent do it</h3>
  <p>Copy this prompt into Claude Code, Codex or another coding agent. It runs the command, finishes what it can and gives you a short list of what only you can do: sign in, allow access, type a key into the tool’s own prompt.</p>
  <div class="agent-prompt" id="setup-prompt" tabindex="0" role="region" aria-label="Setup prompt for your coding agent" data-copy-prompt>
   <p>Set up PassionCode.ai on this computer, or check and repair it if it is already set up. Run npx --yes @passioncode-ai/passioncode@latest setup --yes --json (it needs Node 18 or newer) and read its JSON: on macOS it installs the missing apps from their signed releases, and on Windows and Linux it names each app's download page instead; everywhere it installs the skills and every MCP server, repairs whatever is wrong, and checks everything again. Do not download or install anything by hand, and never stop or kill a running app. Then run each product onboarding step it lists that an agent may run, never ask me for a key or password in the chat (the tools open their own hidden prompts), and finish with npx --yes @passioncode-ai/passioncode@latest doctor. Tell me briefly what you set up or fixed, what still fails, and the numbered steps only I can do, such as signing in or, on Windows and Linux, installing the apps from their pages and running the command again, and remind me to restart you so the new skills and MCP servers load.</p>
  </div>
 </div>
 </div>
 <p class="section-note">Fabric is an early preview and needs Docker and the Supabase CLI on every system. On macOS the command installs it when both are present, and otherwise tells you what to add; on Windows and Linux, download it from <a href="/fabric/#download">the Fabric page</a> and install it first.</p>
 <details class="manual-setup" id="by-hand"><summary>Prefer to do it by hand?</summary>
  <ol class="setup-steps guide-steps">
  <li id="fabric"><span>01</span><div><h3>Add Fabric</h3><p>Fabric is the home for your projects and their agents: each project keeps its purpose, board, decisions and releases there. Its first screen offers four actions: create an agent, adapt one you already have, open a project or create one. It is an early preview: it needs Docker and the Supabase CLI, and its conversation saves messages but does not reply yet.</p><div class="hero-actions"><a class="button button-primary" href="/fabric/download/macos">Download Fabric <span data-live="fabric.version">0.3.5</span> for macOS <span aria-hidden="true">↓</span></a><a class="text-link" href="/fabric/#download">For Windows and Linux</a><a class="text-link" href="/fabric/#download">Requirements and limits</a></div><p class="step-meta">Apple silicon and Intel · signed and notarized · SHA-256 <code data-live="fabric.assets.macos.sha256">1e54fe557f2752817bb00303a93d595c812609b355f6850420026663cf39b98b</code> · <a href="https://github.com/passioncode-ai/fabric/releases/tag/v0.3.5" data-live-href="fabric.releaseUrl">release notes</a></p></div></li>
  <li id="dashboards"><span>02</span><div><h3>Add Fabric Dashboards</h3><p>Fabric Dashboards shows every local agent service in one window. Download it, then connect it to your coding agent over MCP.</p><div class="hero-actions"><a class="button button-secondary" href="/dashboards/download/macos">Download Fabric Dashboards <span data-live="dashboards.version">0.7.10</span> <span aria-hidden="true">↓</span></a><a class="text-link" href="/dashboards/#download">For Windows and Linux</a></div><pre class="copyable"><code>claude mcp add --scope user fabric-dashboards -- "/Applications/Fabric Dashboards.app/Contents/Resources/bin/fabric-dashboards-mcp"</code></pre></div></li>
 </ol>
  <p class="step-meta">Switchboard, Project Observatory and Fabric Inbox each have their own download: <a href="/switchboard/#download">Switchboard</a> · <a href="/observatory/#get-started">Observatory</a> · <a href="/inbox/#download">Inbox</a></p>
 </details>
</section>

<section class="section guide" aria-labelledby="steps-title">
 <h2 id="steps-title" class="visually-hidden">Next steps</h2>
 <ol class="setup-steps guide-steps">
  <li id="build" class="reveal"><span>01</span><div><h3>Create or adapt an agent</h3><p>In Claude Code or Codex, ask for what you need, or start from Fabric’s Create and Adapt actions; the work runs in your coding agent’s console either way. The Fabric Agent Adapter skill asks its questions first and shows its plan before it changes anything; adapting works on a new <code>fabric-adapter</code> branch. You get a contract, a dashboard, tests and a conformance report.</p><p class="step-prompt"><span>new</span> Create a Fabric agent that checks our app store reviews every morning and drafts replies</p><p class="step-prompt"><span>adapt</span> Adapt this repository to Fabric</p></div></li>
  <li id="run" class="reveal"><span>02</span><div><h3>Run it and see it</h3><p>Fabric Dashboards shows every local agent service in one window; your agent can start, stop and open them over MCP. The one command installs it on macOS and connects it to your coding agent.</p></div></li>
  <li id="family" class="reveal"><span>03</span><div><h3>Add the next agent to the same project</h3><p>Build the next agent the same way and give it the same project in Fabric. Agents connected to Fabric share one project’s board, memory and hand-offs, so one picks up where the other stopped. <a href="/fabric/agents/">Which agents connect today</a></p></div></li>
 </ol>
 <p class="section-note" id="pipeline">For the changes your agents make, we recommend task-pipeline, a separate open-source skill: <a href="/vision/#pipeline">what it does and how to install it</a></p>
</section>

<section class="section contribute" id="contribute" aria-labelledby="contribute-title">
 <div class="section-heading story-heading"><p class="section-number">CONTRIBUTE</p><h2 id="contribute-title">Found something to fix?<br>Send a pull request</h2><p>Every product repository is public and names its test command in <code>AGENTS.md</code>. Follow the organization’s <a href="https://github.com/passioncode-ai/.github/blob/main/CONTRIBUTING.md">CONTRIBUTING.md</a> and open a pull request; opening it is your agreement to the repository’s <code>CLA.md</code>.</p></div>
 <div class="repo-list">
  <a href="https://github.com/passioncode-ai/fabric">fabric</a><a href="https://github.com/passioncode-ai/fabric-switchboard">fabric-switchboard</a><a href="https://github.com/passioncode-ai/fabric-dashboards">fabric-dashboards</a><a href="https://github.com/passioncode-ai/fabric-inbox">fabric-inbox</a><a href="https://github.com/passioncode-ai/project-observatory-dashboard">project-observatory-dashboard</a><a href="https://github.com/passioncode-ai/fabric-agent-adapter">fabric-agent-adapter</a><a href="https://github.com/passioncode-ai/fabric-agent-contract">fabric-agent-contract</a><a href="https://github.com/passioncode-ai/passioncode">passioncode</a><a href="https://github.com/passioncode-ai/okolos">okolos</a><a href="https://github.com/passioncode-ai/fabric-vr">fabric-vr</a><a href="https://github.com/passioncode-ai/passioncode-ai.github.io">passioncode-ai.github.io</a>
 </div>
</section>

<section class="closing" aria-labelledby="closing-title"><img src="/assets/passioncode-mark.svg" width="72" height="72" alt=""><p class="section-number">FOR ORGANIZATIONS</p><h2 id="closing-title">Want it running<br>for your whole team?</h2><p>We map your processes, estimate what agents can take over, and set it up with you or for you.</p><a class="button button-primary" href="/business/">Estimate and request <span aria-hidden="true">→</span></a></section>
</main>
<footer class="story-footer">
 <div><a class="brand footer-brand" href="/"><img src="/assets/passioncode-mark.svg" width="32" height="32" alt=""><span>PassionCode<span class="brand-dot">.ai</span></span></a><p>From vibe coding to passion coding</p></div>
 <nav aria-label="Footer navigation"><a href="/start/">Get started</a><a href="/vision/">Vision</a><a href="/business/">For organizations</a><a href="/switchboard/">Switchboard</a><a href="/observatory/">Observatory</a><a href="/inbox/">Inbox</a><a href="/dashboards/">Dashboards</a><a href="/fabric/">Fabric</a><a href="/#source">GitHub &amp; source</a><a href="/#about">About</a><a href="/#investors">Investors</a><a href="/#contributors">Contributors</a><a href="/#press">Press</a><a href="/design-system/">Design system</a><a href="/privacy/">Privacy</a><a href="mailto:commercial@passioncode.ai">commercial@passioncode.ai</a><a href="https://x.com/sshlg93">X <span aria-hidden="true">↗</span></a></nav>
</footer>
</body></html>