[{"data":1,"prerenderedAt":4},["ShallowReactive",2],{"readme:fractal":3},"\u003Ch1>fractal\u003C\u002Fh1>\n\u003Cp>\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fplasma-ai\u002Ffractal\u002Fblob\u002Fmain\u002FLICENSE\" rel=\"nofollow ugc noopener\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-Apache--2.0-blue.svg\" alt=\"license\" \u002F>\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fplasma-ai\u002Ffractal\u002Factions\u002Fworkflows\u002Fbuild.yaml\" rel=\"nofollow ugc noopener\">\u003Cimg src=\"https:\u002F\u002Fgithub.com\u002Fplasma-ai\u002Ffractal\u002Factions\u002Fworkflows\u002Fbuild.yaml\u002Fbadge.svg\" alt=\"build\" \u002F>\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fplasma-ai\u002Ffractal\u002Factions\u002Fworkflows\u002Fdocs.yaml\" rel=\"nofollow ugc noopener\">\u003Cimg src=\"https:\u002F\u002Fgithub.com\u002Fplasma-ai\u002Ffractal\u002Factions\u002Fworkflows\u002Fdocs.yaml\u002Fbadge.svg\" alt=\"docs\" \u002F>\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fplasma-ai\u002Ffractal\u002Factions\u002Fworkflows\u002Flint.yaml\" rel=\"nofollow ugc noopener\">\u003Cimg src=\"https:\u002F\u002Fgithub.com\u002Fplasma-ai\u002Ffractal\u002Factions\u002Fworkflows\u002Flint.yaml\u002Fbadge.svg\" alt=\"lint\" \u002F>\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fplasma-ai\u002Ffractal\u002Factions\u002Fworkflows\u002Ftests.yaml\" rel=\"nofollow ugc noopener\">\u003Cimg src=\"https:\u002F\u002Fgithub.com\u002Fplasma-ai\u002Ffractal\u002Factions\u002Fworkflows\u002Ftests.yaml\u002Fbadge.svg\" alt=\"tests\" \u002F>\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Fcodecov.io\u002Fgh\u002Fplasma-ai\u002Ffractal\" rel=\"nofollow ugc noopener\">\u003Cimg src=\"https:\u002F\u002Fcodecov.io\u002Fgh\u002Fplasma-ai\u002Ffractal\u002Fbranch\u002Fmain\u002Fgraph\u002Fbadge.svg?token=FB0T12O2ZP\" alt=\"codecov\" \u002F>\u003C\u002Fa>\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fpre-commit\u002Fpre-commit\" rel=\"nofollow ugc noopener\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fpre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white\" alt=\"pre-commit\" \u002F>\u003C\u002Fa>\u003C\u002Fp>\n\u003Cp>Hierarchical agent loops with recursive self-organization.\u003C\u002Fp>\n\u003Cp>In a fractal, autonomous agent loops arrange themselves into a tree: a node\niterates toward a goal in its own \u003Ccode>git worktree\u003C\u002Fcode> and spawns child nodes for\nseparable subtasks, so the tree grows to fit the problem rather than a fixed\nplan. Hard caps (iterations, depth, children, cost, time) keep each loop\nbounded, and an operator can steer or stop it at any point. Run metadata\n(including cost) lands in one local \u003Ccode>SQLite\u003C\u002Fcode> database, which can be interacted\nwith live in a terminal UI.\u003C\u002Fp>\n\u003Cp>\u003Cimg src=\"https:\u002F\u002Fraw.githubusercontent.com\u002Fplasma-ai\u002Ffractal\u002Fmain\u002Fdocs\u002F_static\u002Ftui.png\" alt=\"fractal TUI dashboard\" \u002F>\u003C\u002Fp>\n\u003Cblockquote>\n\u003Cp>[!WARNING]\n\u003Cstrong>Nodes run their agent without permission prompts by default.\u003C\u002Fstrong> Unattended\nloops cannot stop to ask, so every seeded agent config disables the approval\ngate — Claude \u003Ccode>bypassPermissions\u003C\u002Fcode>, Codex \u003Ccode>danger-full-access\u003C\u002Fcode>, Grok\n\u003Ccode>--always-approve\u003C\u002Fcode>, opencode \u003Ccode>--auto\u003C\u002Fcode>, omp \u003Ccode>--yolo\u003C\u002Fcode>. A node can therefore run\nany command its agent decides to run, with your credentials and your machine's\nreach. The per-node \u003Ccode>git worktree\u003C\u002Fcode> isolates the \u003Cem>branch\u003C\u002Fem> it commits to, not\nthe filesystem, the network, or anything else outside it. Only launch nodes\nwhose task you would trust to run unsupervised, and prefer a sandboxed or\notherwise disposable host for anything else.\u003C\u002Fp>\n\u003C\u002Fblockquote>\n\u003Chr \u002F>\n\u003Cp>\u003Cstrong>Source\u003C\u002Fstrong>:\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fplasma-ai\u002Ffractal\" rel=\"nofollow ugc noopener\">https:\u002F\u002Fgithub.com\u002Fplasma-ai\u002Ffractal\u003C\u002Fa>\u003C\u002Fp>\n\u003Cp>\u003Cstrong>Package\u003C\u002Fstrong>:\n\u003Ca href=\"https:\u002F\u002Fpypi.org\u002Fproject\u002Fplasma-fractal\u002F\" rel=\"nofollow ugc noopener\">https:\u002F\u002Fpypi.org\u002Fproject\u002Fplasma-fractal\u002F\u003C\u002Fa>\u003C\u002Fp>\n\u003Cp>\u003Cstrong>Documentation\u003C\u002Fstrong>:\n\u003Ca href=\"https:\u002F\u002Fdocs.plasma.ai\u002Ffractal\" rel=\"nofollow ugc noopener\">https:\u002F\u002Fdocs.plasma.ai\u002Ffractal\u003C\u002Fa>\u003C\u002Fp>\n\u003Chr \u002F>\n\u003Ch2>Installation\u003C\u002Fh2>\n\u003Cp>Install the \u003Ccode>fractal\u003C\u002Fcode> package from PyPI:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-bash\">pip install plasma-fractal\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>or\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-bash\">pip install fractal\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Use \u003Ccode>pipx install\u003C\u002Fcode> or \u003Ccode>uv tool install\u003C\u002Fcode> to install the package in an isolated\nenvironment. If you use one of these two methods, you must also install\n\u003Ccode>plasma-wiki\u003C\u002Fcode> (a plain \u003Ccode>pip\u003C\u002Fcode> install pulls \u003Ccode>plasma-wiki\u003C\u002Fcode> and puts \u003Ccode>wiki\u003C\u002Fcode> on your\n\u003Ccode>PATH\u003C\u002Fcode>, but this is not the case when using \u003Ccode>pipx install\u003C\u002Fcode> or\n\u003Ccode>uv tool install\u003C\u002Fcode>).\u003C\u002Fp>\n\u003Cp>\u003Ccode>uv tool install plasma-fractal --with-executables-from plasma-wiki\u003C\u002Fcode> does the\nsame in one command.\u003C\u002Fp>\n\u003Cp>Open the dashboard from your project root with \u003Ccode>fractal open\u003C\u002Fcode> (requires an\ninitialized fractal). Pass \u003Ccode>--light\u003C\u002Fcode> if your terminal uses a light color scheme.\u003C\u002Fp>\n\u003Ch3>Skill\u003C\u002Fh3>\n\u003Cp>Install the skill for your agent via the plugin marketplace (Claude Code and\nCodex):\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-bash\"># Claude Code\n\u002Fplugin marketplace add plasma-ai\u002Fplugins\n\u002Fplugin install fractal@plasma\n\n# Codex\ncodex plugin marketplace add plasma-ai\u002Fplugins\ncodex plugin add fractal@plasma\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Another install route is from the CLI, which copies (or symlinks) the fractal\nand wiki skills into \u003Ccode>~\u002F.claude\u002Fskills\u003C\u002Fcode> and \u003Ccode>~\u002F.agents\u002Fskills\u003C\u002Fcode> (add \u003Ccode>--project\u003C\u002Fcode>\nfor the current project only):\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-bash\">fractal install [\n\u003C\u002Fcode>\u003C\u002Fpre>\n",1785169769196]