{"id":50832659,"url":"https://github.com/figs-so/create-openfigs","last_synced_at":"2026-06-14T01:05:13.687Z","repository":{"id":364582004,"uuid":"1261563868","full_name":"figs-so/create-openfigs","owner":"figs-so","description":"Scaffold a new OpenFigs fleet in one line — npm create openfigs.","archived":false,"fork":false,"pushed_at":"2026-06-13T15:17:30.000Z","size":18,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-13T17:11:21.630Z","etag":null,"topics":["agents","ai-agents","claude-code","cli","create-app","figs","openfigs","scaffolding"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/figs-so.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-06T21:29:34.000Z","updated_at":"2026-06-13T15:07:47.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/figs-so/create-openfigs","commit_stats":null,"previous_names":["figs-so/create-openfigs"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/figs-so/create-openfigs","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/figs-so%2Fcreate-openfigs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/figs-so%2Fcreate-openfigs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/figs-so%2Fcreate-openfigs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/figs-so%2Fcreate-openfigs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/figs-so","download_url":"https://codeload.github.com/figs-so/create-openfigs/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/figs-so%2Fcreate-openfigs/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34305789,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-13T02:00:06.617Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agents","ai-agents","claude-code","cli","create-app","figs","openfigs","scaffolding"],"created_at":"2026-06-14T01:05:12.794Z","updated_at":"2026-06-14T01:05:13.682Z","avatar_url":"https://github.com/figs-so.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# create-openfigs\n\n**Scaffold one [OpenFigs](https://github.com/figs-so/openfigs) employee in one line.**\n\n```bash\nnpm create openfigs@latest my-agent\n```\n\nOpenFigs is a small, file-based skeleton for building one back-office **AI employee** — an agent\nthat owns a recurring job, learns from its work, and reports to a human through\n[Figs](https://app.figs.so). This is its installer.\n\n## What it does\n\n```bash\nnpm create openfigs@latest [dir]\n# or\nnpx create-openfigs [dir] [--yes] [--here] [--from \u003csource\u003e] [--no-init]\n```\n\n1. **Fetches the current OpenFigs skeleton** into `dir` (defaults to `my-agent`; prompts if\n   omitted) — straight from [`figs-so/openfigs`](https://github.com/figs-so/openfigs) at runtime,\n   so you always get the latest.\n2. **Regenerates the runtime symlink** — `CLAUDE.md` → `AGENTS.md` (and `.claude/skills` →\n   `.agents/skills`) — so Claude Code, Codex, and opencode all read one source of truth. (This is\n   why a scaffolder beats a plain ZIP download: the link is rebuilt deterministically, never\n   shipped as a broken text file.)\n3. **Stamps the agent's name** into the skeleton's placeholders.\n4. **Runs `figs init`** (account-free, zero-flag) — so the agent has a **local identity + activity\n   journal** and is ready to work with no account. (Identity is minted here, per clone — never\n   shipped in the skeleton, so two agents never collide. Skip with `--no-init`.)\n5. **`git init`s the repo** with a first commit — a scaffolded agent is a real repo (the skeleton\n   commits `config.json` / `agent.json` / `CONTRACT.md`; the journal + credentials stay gitignored).\n   **Skipped if the target lands inside an existing repo** (e.g. `--here` in a monorepo).\n\nThen:\n\n```bash\ncd my-agent\n# read AGENTS.md, fill your charter in .figs/agent.json (role, mandate, department)\n# work — figs records you locally from day one (no account needed)\n# when your team should see it:\nnpx @figs-so/cli@latest login    # opens your browser — sign up \u0026 approve\nnpx @figs-so/cli@latest link     # join a workspace\nnpx @figs-so/cli@latest push     # appear on the org chart\n```\n\n\u003e **One repo = one employee.** Want a team? Run this once per job and point them at the **same Figs\n\u003e workspace** — the org chart groups them by each agent's `department`. **Never copy a scaffolded\n\u003e folder** to make another (a copy carries the original's identity); scaffold fresh so each mints\n\u003e its own.\n\n### Options\n\n| Flag | What |\n|---|---|\n| `--from \u003csource\u003e` | skeleton source: `github:owner/repo[#ref]` or a local path (default: `github:figs-so/openfigs`; or set `OPENFIGS_SOURCE`) |\n| `--here` | scaffold into the current directory |\n| `--no-init` | skip running `figs init` (you'll run it yourself) |\n| `-y`, `--yes` | non-interactive (no prompts) |\n| `-h`, `--help` | usage |\n\nPrefer the raw skeleton with no init/prompts? `npx degit figs-so/openfigs my-agent`.\n\n## How the skeleton is fetched (always current)\n\nThe skeleton is **not bundled** here — it's fetched from the canonical\n[`openfigs`](https://github.com/figs-so/openfigs) repo **at runtime** (zero-dependency: Node\n`fetch` + the GitHub tarball + `tar`). So new agents always get the latest skeleton, and this\npackage only needs a release when the *scaffolder logic itself* changes — never just because\nopenfigs changed.\n\nPoint it elsewhere with `--from` (a fork, a pinned `#tag`, or a local checkout):\n\n```bash\nnpx create-openfigs my-agent --from github:me/openfigs-fork#v1.2.0\nnpx create-openfigs my-agent --from ../openfigs          # local path (offline / dev)\n```\n\n**Developing locally** (with the `openfigs` repo as a sibling directory):\n\n```bash\nnpm test     # smoke-test against ../openfigs (no network): scaffold + assert the live symlink\n```\n\n## Licensing\n\n- **This repo — the scaffolder: [MIT](./LICENSE).** Use it, fork it, point it at your own skeleton\n  with `--from`.\n- **The hosted app at [app.figs.so](https://app.figs.so) is a commercial product** (closed source).\n  Everything an agent records is `.figs`, an open format you can read or export anytime.\n\nBy contributing, you agree your contributions are MIT-licensed. See [`CONTRIBUTING.md`](./CONTRIBUTING.md).\n\n## The Figs ecosystem\n\nFigs is one stack in three pieces — **build → report → govern**. Land on any repo; here's the whole picture:\n\n| Layer | Repo | License | Role |\n|---|---|---|---|\n| 🏗️ Build | **[OpenFigs](https://github.com/figs-so/openfigs)** | MIT | build trustworthy back-office AI employees — conventions + skeleton, runtime-agnostic |\n| 🚀 On-ramp | **[create-openfigs](https://github.com/figs-so/create-openfigs)** | MIT | `npm create openfigs` — scaffold one employee in one line — **← you're here** |\n| 📤 Report | **[`.figs` + CLI](https://github.com/figs-so/figs)** | MIT | the open standard an agent reports its state in |\n| 👁️ Govern | **[Figs app](https://app.figs.so)** | hosted | the org chart + handoff inbox humans read |\n\n## Links\n\n- 🌐 Landing: **[figs.so](https://figs.so)**\n- 🖥️ App: **[app.figs.so](https://app.figs.so)**\n- 📦 npm: **[create-openfigs](https://www.npmjs.com/package/create-openfigs)**\n- 🏗️ Skeleton: **[figs-so/openfigs](https://github.com/figs-so/openfigs)**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffigs-so%2Fcreate-openfigs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffigs-so%2Fcreate-openfigs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffigs-so%2Fcreate-openfigs/lists"}