identityforge
Advanced tools
+1
-1
| import { resolveApiKey, resolveApiUrl } from "./config.js"; | ||
| import { isVersionGreater } from "./updateCheck.js"; | ||
| export const CLI_VERSION = "0.3.9"; | ||
| export const CLI_VERSION = "0.3.10"; | ||
| let apiClient = "cli"; | ||
@@ -5,0 +5,0 @@ /** Select the client identity used by subsequent API requests. */ |
+1
-1
@@ -104,3 +104,3 @@ import { spawn } from "node:child_process"; | ||
| const href = authorizeUrl.toString(); | ||
| process.stdout.write(`Opening your browser to sign in…\nNo account yet? Create one there and confirm the email; this login resumes automatically.\nIf it doesn't open, paste this URL:\n ${href}\n`); | ||
| process.stdout.write(`Opening your browser to sign in…\nNo account yet? Sign up there, complete the security check, select Send verification email, and open its link.\nThen approve the resumed authorization; the CLI receives the key automatically.\nIf it doesn't open, paste this URL:\n ${href}\n`); | ||
| openBrowser(href); | ||
@@ -107,0 +107,0 @@ }); |
+1
-1
| { | ||
| "name": "identityforge", | ||
| "version": "0.3.9", | ||
| "version": "0.3.10", | ||
| "mcpName": "io.identityforge/mcp", | ||
@@ -5,0 +5,0 @@ "description": "Agent-native brand naming, domain research, and design systems through one CLI and MCP server.", |
+70
-39
@@ -9,9 +9,12 @@ <p align="center"> | ||
| <p align="center">Design systems, brand naming, and domain research for coding agents.</p> | ||
| <p align="center"><strong>The branding pipeline for the agentic era.</strong></p> | ||
| <p align="center">Give coding agents a complete design system, then carry it from first build to later updates and client handoff.</p> | ||
| <p align="center"> | ||
| <a href="#for-people">For people</a> · | ||
| <a href="#for-agents">For agents</a> · | ||
| <a href="#mcp-tools">MCP tools</a> · | ||
| <a href="#cli-commands">CLI reference</a> | ||
| <a href="#capabilities">Capabilities</a> · | ||
| <a href="#watch-it-work">Watch it work</a> · | ||
| <a href="#reference">Reference</a> | ||
| </p> | ||
@@ -21,2 +24,3 @@ | ||
| <a href="https://www.npmjs.com/package/identityforge"><img src="https://img.shields.io/npm/v/identityforge" alt="npm version"></a> | ||
| <a href="https://www.npmjs.com/package/identityforge"><img src="https://img.shields.io/npm/dw/identityforge?label=weekly%20downloads" alt="weekly npm downloads"></a> | ||
| <a href="https://github.com/KasayoDotCom/identityforge-mcp/actions/workflows/ci.yml"><img src="https://github.com/KasayoDotCom/identityforge-mcp/actions/workflows/ci.yml/badge.svg" alt="CI status"></a> | ||
@@ -28,46 +32,29 @@ <a href="./LICENSE"><img src="https://img.shields.io/npm/l/identityforge" alt="MIT license"></a> | ||
| Identity Forge gives a coding agent a complete visual system before it starts | ||
| building. Choose a design kit yourself, or let the agent rank the catalog | ||
| against your product and the mood you want. Each kit includes typography, | ||
| semantic color tokens, layout, motifs, dos and don'ts, and a `DESIGN.md` the | ||
| agent can build from. | ||
| - **Start with a complete design kit.** Typography, semantic color tokens, layout, spacing, motifs, dos and don'ts, and an implementation-ready `DESIGN.md` travel together. | ||
| - **Choose with evidence.** Your agent can search the catalog, rank kits for the product and its surfaces, inspect the full brief, and compare nearby directions. | ||
| - **Apply safely.** Identity Forge writes the brief, tokens, and a version stamp, then protects files that changed locally. | ||
| - **Compose the whole brand.** Add an image direction, interface style, and page recipes while keeping the supplied product, person, or object recognizable. | ||
| - **Carry decisions forward.** Version history, drift checks, naming and domain research, saved projects, client shares, and feedback stay in the same workflow. | ||
| The agent can export the kit as CSS, Tailwind v3 or v4, shadcn registry data, | ||
| DTCG tokens, or JSON, then apply it with conflict protection. Brand naming, | ||
| domain research, and shareable client projects live in the same workflow. | ||
| Public Free kits are ready immediately. An account adds persistent projects, saved work, authenticated quota, and Pro access. | ||
| Public Free kits work without an account. [Browse the design kits](https://identityforge.io/kits) | ||
| or [read how the agent flow works](https://identityforge.io/for-agents) before | ||
| installing anything. | ||
| [Browse the design kits](https://identityforge.io/kits) · [See the agent workflow](https://identityforge.io/for-agents) · [Read the HTTP API](https://identityforge.io/api/v1) | ||
| ### Watch it work | ||
| The three-minute lifecycle film follows a design system from the first choice | ||
| through later updates, an older-site rebuild, and a client handoff. | ||
| https://github.com/user-attachments/assets/b5125f58-6918-4355-b849-6863a4345a21 | ||
| [Download the full-resolution 1080p WebM](https://github.com/KasayoDotCom/identityforge-mcp/releases/download/v0.3.9/identity-forge-lifecycle-explainer.webm). | ||
| ## For agents | ||
| Install the local MCP server into the client you use: | ||
| Install the local MCP server into your coding agent: | ||
| ```bash | ||
| npx --yes identityforge@latest install --client claude-code # Claude Code | ||
| npx --yes identityforge@latest install --client cursor # Cursor | ||
| npx --yes identityforge@latest install --client vscode # VS Code / Copilot | ||
| npx --yes identityforge@latest install --client codex # Codex | ||
| npx --yes identityforge@latest install --client claude-code | ||
| ``` | ||
| Also supported: `gemini`, `opencode`, `pi`. Every client runs the same local | ||
| stdio server, and `install` merges into your existing config rather than | ||
| replacing it. Config paths for all seven are in | ||
| [Install into an agent](#install-into-an-agent). | ||
| Use `cursor`, `vscode`, `codex`, `gemini`, `opencode`, or `pi` in place of | ||
| `claude-code`. The installer merges the MCP entry into the client's existing | ||
| configuration. | ||
| Public Free kits work immediately, without a key. Tell your agent: | ||
| Then tell your agent: | ||
| > Use Identity Forge to pick a theme that fits this product, apply it, and follow the DESIGN.md. | ||
| Sign in for persistent projects, saved work, authenticated quota, or Pro access: | ||
| Sign in when you want persistent projects, saved work, authenticated quota, or Pro access: | ||
@@ -78,6 +65,33 @@ ```bash | ||
| No account yet? Browser signup sends a confirmation email. Open the email link | ||
| and confirm on the page; the pending CLI authorization then resumes | ||
| automatically. | ||
| No account yet? In the browser, sign up, complete the security check, select | ||
| `Send verification email`, and open its link. Then select | ||
| `Confirm email and continue`, approve the resumed authorization, and the CLI | ||
| receives the key automatically. | ||
| ## Capabilities | ||
| Once connected, your agent gets 61 tools grouped around real jobs: | ||
| - **Find the right system:** search, rank, compare, and inspect complete design kits. | ||
| - **Build from it:** export `DESIGN.md`, CSS, Tailwind v3 or v4, shadcn registry data, DTCG tokens, or JSON. | ||
| - **Apply and maintain it:** preview writes, protect local changes, inspect status, compare versions, and follow drift. | ||
| - **Direct the presentation:** codify image directions, interface styles, and page recipes around the chosen kit. | ||
| - **Build a client-ready brand:** compose variations, generate mockups, share a review link, and act on feedback. | ||
| - **Name and research:** manage a persistent naming board and collect domain, trademark, registrar, DNS, RDAP, and search evidence. | ||
| ## Watch it work | ||
| The three-minute lifecycle film follows a design system from the first choice through later updates, an older-site rebuild, and a client handoff. | ||
| https://github.com/user-attachments/assets/b5125f58-6918-4355-b849-6863a4345a21 | ||
| [Download the full-resolution 1080p WebM](https://github.com/KasayoDotCom/identityforge-mcp/releases/download/v0.3.9/identity-forge-lifecycle-explainer.webm). | ||
| ## Reference | ||
| The complete behavior and command inventory stays here for agents and implementation work. Expand only the part you need. | ||
| <details> | ||
| <summary><strong>Discovery and installation details</strong></summary> | ||
| ## Judged discovery | ||
@@ -118,4 +132,4 @@ | ||
| The repository also bundles the MCP server with an Agent Skill that tells the agent when | ||
| to use Identity Forge, how free and authenticated access differ, and how browser signup | ||
| resumes after email confirmation. | ||
| to use Identity Forge, how free and authenticated access differ, and how to guide a human | ||
| through `Send verification email` before the pending browser authorization resumes. | ||
@@ -145,2 +159,7 @@ Claude Code: | ||
| </details> | ||
| <details> | ||
| <summary><strong>MCP tools, workflows, safety, and version behavior</strong></summary> | ||
| ## MCP tools | ||
@@ -357,2 +376,7 @@ | ||
| </details> | ||
| <details> | ||
| <summary><strong>Full CLI command reference</strong></summary> | ||
| ## CLI commands | ||
@@ -491,2 +515,7 @@ | ||
| </details> | ||
| <details> | ||
| <summary><strong>Authentication, telemetry, and Docker</strong></summary> | ||
| ## Authentication | ||
@@ -519,2 +548,4 @@ | ||
| </details> | ||
| ## Links | ||
@@ -521,0 +552,0 @@ |
Sorry, the diff of this file is too big to display
Sorry, the diff of this file is too big to display
Long strings
Supply chain riskContains long string literals, which may be a sign of obfuscated or packed code.
URL strings
Supply chain riskPackage contains fragments of external URLs or IP addresses, which the package may be accessing at runtime.
Long strings
Supply chain riskContains long string literals, which may be a sign of obfuscated or packed code.
URL strings
Supply chain riskPackage contains fragments of external URLs or IP addresses, which the package may be accessing at runtime.
342712
0.62%5738
0.03%555
5.92%