Skip to content

Commit 00d644b

Browse files
committed
rebrand: migrate to looptech-ai/understand-quickly + drop private-MVP banner
- Update all references in README, registry.json, mcp/, cli/, site/, .github/. - Replace private-MVP status callout with semver release badge. - Fix CLI buildEntry test that hardcoded the prior owner.
1 parent 144da2c commit 00d644b

12 files changed

Lines changed: 42 additions & 43 deletions

File tree

.github/ISSUE_TEMPLATE/config.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
blank_issues_enabled: false
22
contact_links:
33
- name: Browse the registry
4-
url: https://amacsmith.github.io/understand-quickly/
4+
url: https://looptech-ai.github.io/understand-quickly/
55
about: See what's already indexed before opening a new issue.
66
- name: Add your repo (preferred path)
7-
url: https://github.com/amacsmith/understand-quickly/blob/main/CONTRIBUTING.md
7+
url: https://github.com/looptech-ai/understand-quickly/blob/main/CONTRIBUTING.md
88
about: A PR is faster than an issue for most additions.

README.md

Lines changed: 10 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -6,13 +6,12 @@
66

77
Point AI agents at any indexed repo and they get a current, schema-validated graph — no scraping, no LLM cost on the registry side.
88

9-
[![sync](https://github.com/amacsmith/understand-quickly/actions/workflows/sync.yml/badge.svg)](https://github.com/amacsmith/understand-quickly/actions/workflows/sync.yml)
10-
[![pages](https://github.com/amacsmith/understand-quickly/actions/workflows/pages.yml/badge.svg)](https://amacsmith.github.io/understand-quickly/)
9+
[![sync](https://github.com/looptech-ai/understand-quickly/actions/workflows/sync.yml/badge.svg)](https://github.com/looptech-ai/understand-quickly/actions/workflows/sync.yml)
10+
[![pages](https://github.com/looptech-ai/understand-quickly/actions/workflows/pages.yml/badge.svg)](https://looptech-ai.github.io/understand-quickly/)
11+
[![release](https://img.shields.io/github/v/tag/looptech-ai/understand-quickly?label=release&sort=semver)](https://github.com/looptech-ai/understand-quickly/releases)
1112
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
1213

13-
> **Status:** private MVP under [`amacsmith/understand-quickly`](https://github.com/amacsmith/understand-quickly). Will move to a public org once core flows are battle-tested. Live registry at <https://amacsmith.github.io/understand-quickly/>.
14-
15-
[**Browse →**](https://amacsmith.github.io/understand-quickly/) · [**Add your repo (wizard)**](https://amacsmith.github.io/understand-quickly/add.html) · [**Agent quickstart**](#quickstart) · [**Design spec**](docs/superpowers/specs/2026-05-07-understand-quickly-registry-design.md)
14+
[**Browse →**](https://looptech-ai.github.io/understand-quickly/) · [**Add your repo (wizard)**](https://looptech-ai.github.io/understand-quickly/add.html) · [**Agent quickstart**](#quickstart) · [**Design spec**](docs/superpowers/specs/2026-05-07-understand-quickly-registry-design.md)
1615

1716
</div>
1817

@@ -37,18 +36,18 @@ Point AI agents at any indexed repo and they get a current, schema-validated gra
3736

3837
**I'm an AI agent / SDK user.**
3938
```bash
40-
curl -fsSL https://amacsmith.github.io/understand-quickly/registry.json
39+
curl -fsSL https://looptech-ai.github.io/understand-quickly/registry.json
4140
```
4241
Pick entries with `status: "ok"`. Fetch `entry.graph_url`. Cache by `last_sha`. That's the whole API.
4342

4443
**I want to register my repo.** Pick the path that fits:
45-
- 🖱️ **30-second wizard:** [Add your repo →](https://amacsmith.github.io/understand-quickly/add.html). Fills the issue for you; the bot opens the PR.
44+
- 🖱️ **30-second wizard:** [Add your repo →](https://looptech-ai.github.io/understand-quickly/add.html). Fills the issue for you; the bot opens the PR.
4645
- 💻 **From your terminal:** `npx @understand-quickly/cli add` — auto-detects everything.
4746
- ✍️ **Manual PR:** see [Add your repo](#add-your-repo) below.
4847

4948
**I'm a developer / contributor.**
5049
```bash
51-
git clone https://github.com/amacsmith/understand-quickly
50+
git clone https://github.com/looptech-ai/understand-quickly
5251
cd understand-quickly
5352
npm install && npm test
5453
```
@@ -111,7 +110,7 @@ Contributions that would push us off the free tier are reviewed under that lens.
111110
## Agent quickstart
112111

113112
```bash
114-
curl -fsSL https://amacsmith.github.io/understand-quickly/registry.json
113+
curl -fsSL https://looptech-ai.github.io/understand-quickly/registry.json
115114
```
116115

117116
Each entry that an agent should trust:
@@ -131,7 +130,7 @@ Schemas: [`schemas/`](./schemas/). Each `format` value (e.g. `understand-anythin
131130

132131
## Add your repo
133132

134-
> **Want the easy path?** Use the [wizard](https://amacsmith.github.io/understand-quickly/add.html) or `npx @understand-quickly/cli add`. The instructions below describe the manual-PR flow.
133+
> **Want the easy path?** Use the [wizard](https://looptech-ai.github.io/understand-quickly/add.html) or `npx @understand-quickly/cli add`. The instructions below describe the manual-PR flow.
135134
136135
1. Run [Understand-Anything](https://github.com/Lum1104/Understand-Anything) (or any supported tool) locally; commit `.understand-anything/knowledge-graph.json` to your repo.
137136
2. Fork this repo.
@@ -244,7 +243,7 @@ npm run render # regenerate README table
244243

245244
## Roadmap
246245

247-
- [x] Static GitHub Pages browser with embedded graph viewer — live at <https://amacsmith.github.io/understand-quickly/>.
246+
- [x] Static GitHub Pages browser with embedded graph viewer — live at <https://looptech-ai.github.io/understand-quickly/>.
248247
- [x] Per-entry semantic search — substring search across `id`/`description`/`tags` in the browser; cross-graph search in the MCP server.
249248
- [x] Thin MCP server wrapping `registry.json` — see [`mcp/`](./mcp/) (stub).
250249
- [x] `entries/<a-z>.json` shard split — read-path implemented; auto-write triggers when index passes 1k entries.

cli/README.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# @understand-quickly/cli
22

3-
Add your repo to the [understand-quickly registry](https://amacsmith.github.io/understand-quickly/) without touching JSON.
3+
Add your repo to the [understand-quickly registry](https://looptech-ai.github.io/understand-quickly/) without touching JSON.
44

55
```bash
66
npx @understand-quickly/cli add
@@ -25,8 +25,8 @@ npx @understand-quickly/cli add
2525
- `--print-entry` — print the entry JSON to stdout and exit (default in non-TTY).
2626
- `--open-issue` — open the prefilled issue URL.
2727
- `--open-pr` — open a PR via `gh` (forks the registry repo).
28-
- `--registry <owner/repo>` — override the registry repo (default: `amacsmith/understand-quickly`).
28+
- `--registry <owner/repo>` — override the registry repo (default: `looptech-ai/understand-quickly`).
2929

3030
## No graph yet?
3131

32-
Pick a tool from the registry's [Supported formats](https://github.com/amacsmith/understand-quickly#supported-formats), run it locally, commit the output, then come back here.
32+
Pick a tool from the registry's [Supported formats](https://github.com/looptech-ai/understand-quickly#supported-formats), run it locally, commit the output, then come back here.

cli/package.json

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -24,10 +24,10 @@
2424
"cli"
2525
],
2626
"license": "MIT",
27-
"homepage": "https://github.com/amacsmith/understand-quickly/tree/main/cli",
27+
"homepage": "https://github.com/looptech-ai/understand-quickly/tree/main/cli",
2828
"repository": {
2929
"type": "git",
30-
"url": "git+https://github.com/amacsmith/understand-quickly.git",
30+
"url": "git+https://github.com/looptech-ai/understand-quickly.git",
3131
"directory": "cli"
3232
}
3333
}

cli/src/add.mjs

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ const KNOWN_FORMATS = [
2626
'generic@1'
2727
];
2828

29-
const DEFAULT_REGISTRY = 'amacsmith/understand-quickly';
29+
const DEFAULT_REGISTRY = 'looptech-ai/understand-quickly';
3030

3131
/** Open a URL in the user's default browser. Best-effort. */
3232
function openUrl(url) {

cli/tests/detect.test.mjs

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -16,23 +16,23 @@ import {
1616
// ---------- parseGitRemote ----------
1717

1818
test('parseGitRemote: SSH URL with .git suffix', () => {
19-
assert.equal(parseGitRemote('[email protected]:amacsmith/understand-quickly.git'), 'amacsmith/understand-quickly');
19+
assert.equal(parseGitRemote('[email protected]:looptech-ai/understand-quickly.git'), 'looptech-ai/understand-quickly');
2020
});
2121

2222
test('parseGitRemote: HTTPS URL with .git suffix', () => {
23-
assert.equal(parseGitRemote('https://github.com/amacsmith/understand-quickly.git'), 'amacsmith/understand-quickly');
23+
assert.equal(parseGitRemote('https://github.com/looptech-ai/understand-quickly.git'), 'looptech-ai/understand-quickly');
2424
});
2525

2626
test('parseGitRemote: HTTPS URL without .git suffix', () => {
27-
assert.equal(parseGitRemote('https://github.com/amacsmith/understand-quickly'), 'amacsmith/understand-quickly');
27+
assert.equal(parseGitRemote('https://github.com/looptech-ai/understand-quickly'), 'looptech-ai/understand-quickly');
2828
});
2929

3030
test('parseGitRemote: HTTPS URL with trailing slash', () => {
31-
assert.equal(parseGitRemote('https://github.com/amacsmith/understand-quickly/'), 'amacsmith/understand-quickly');
31+
assert.equal(parseGitRemote('https://github.com/looptech-ai/understand-quickly/'), 'looptech-ai/understand-quickly');
3232
});
3333

3434
test('parseGitRemote: SSH URL without .git suffix', () => {
35-
assert.equal(parseGitRemote('[email protected]:amacsmith/understand-quickly'), 'amacsmith/understand-quickly');
35+
assert.equal(parseGitRemote('[email protected]:looptech-ai/understand-quickly'), 'looptech-ai/understand-quickly');
3636
});
3737

3838
test('parseGitRemote: junk URL throws', () => {
@@ -103,12 +103,12 @@ test('sniffFormat: prefers understand-anything over generic when both shapes mat
103103

104104
test('buildEntry: minimal valid entry', () => {
105105
const e = buildEntry({
106-
id: 'amacsmith/understand-quickly',
106+
id: 'looptech-ai/understand-quickly',
107107
format: 'generic@1',
108108
graph_url: 'https://example.com/graph.json'
109109
});
110-
assert.equal(e.id, 'amacsmith/understand-quickly');
111-
assert.equal(e.owner, 'amacsmith');
110+
assert.equal(e.id, 'looptech-ai/understand-quickly');
111+
assert.equal(e.owner, 'looptech-ai');
112112
assert.equal(e.repo, 'understand-quickly');
113113
assert.equal(e.format, 'generic@1');
114114
assert.equal(e.graph_url, 'https://example.com/graph.json');
@@ -166,11 +166,11 @@ test('buildIssueUrl: encodes title and body', () => {
166166
graph_url: 'https://example.com/graph.json',
167167
description: 'has & chars and "quotes"'
168168
});
169-
const url = buildIssueUrl('amacsmith/understand-quickly', entry);
169+
const url = buildIssueUrl('looptech-ai/understand-quickly', entry);
170170
// URL is parseable
171171
const parsed = new URL(url);
172172
assert.equal(parsed.hostname, 'github.com');
173-
assert.equal(parsed.pathname, '/amacsmith/understand-quickly/issues/new');
173+
assert.equal(parsed.pathname, '/looptech-ai/understand-quickly/issues/new');
174174
// Special chars round-trip correctly through URLSearchParams.
175175
const body = parsed.searchParams.get('body');
176176
assert.match(body, /has & chars and "quotes"/);

mcp/README.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
# @understand-quickly/mcp
22

33
A thin [Model Context Protocol](https://modelcontextprotocol.io) server that
4-
exposes the [understand-quickly](https://amacsmith.github.io/understand-quickly/)
4+
exposes the [understand-quickly](https://looptech-ai.github.io/understand-quickly/)
55
registry to any MCP client (Claude Desktop, Codex, Cursor, etc.).
66

77
> Status: stub-quality. It works end-to-end but is intentionally minimal —
@@ -62,7 +62,7 @@ Add the following to Claude Desktop's `claude_desktop_config.json` (the path is
6262
"/absolute/path/to/understand-quickly/mcp/src/index.ts"
6363
],
6464
"env": {
65-
"UNDERSTAND_QUICKLY_REGISTRY": "https://amacsmith.github.io/understand-quickly/registry.json"
65+
"UNDERSTAND_QUICKLY_REGISTRY": "https://looptech-ai.github.io/understand-quickly/registry.json"
6666
}
6767
}
6868
}
@@ -89,7 +89,7 @@ If you would rather run the compiled output, swap to:
8989

9090
| Variable | Default | Purpose |
9191
| --- | --- | --- |
92-
| `UNDERSTAND_QUICKLY_REGISTRY` | `https://amacsmith.github.io/understand-quickly/registry.json` | Override the registry source (e.g. point at a local file or a fork). |
92+
| `UNDERSTAND_QUICKLY_REGISTRY` | `https://looptech-ai.github.io/understand-quickly/registry.json` | Override the registry source (e.g. point at a local file or a fork). |
9393

9494
## Current limitations
9595

mcp/src/registry.ts

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ import type {
55
} from "./types.js";
66

77
export const DEFAULT_REGISTRY_URL =
8-
"https://amacsmith.github.io/understand-quickly/registry.json";
8+
"https://looptech-ai.github.io/understand-quickly/registry.json";
99
export const DEFAULT_TTL_MS = 60_000;
1010

1111
interface CacheRecord {

registry.json

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@
88
"repo": "demo-understand-anything",
99
"default_branch": "main",
1010
"format": "understand-anything@1",
11-
"graph_url": "https://amacsmith.github.io/understand-quickly/schemas/__fixtures__/understand-anything/real-sample.json",
11+
"graph_url": "https://looptech-ai.github.io/understand-quickly/schemas/__fixtures__/understand-anything/real-sample.json",
1212
"description": "Demo entry: a hand-built sample knowledge graph in the understand-anything@1 shape.",
1313
"tags": [
1414
"demo",
@@ -27,7 +27,7 @@
2727
"repo": "demo-gitnexus",
2828
"default_branch": "main",
2929
"format": "gitnexus@1",
30-
"graph_url": "https://amacsmith.github.io/understand-quickly/schemas/__fixtures__/gitnexus/real-sample.json",
30+
"graph_url": "https://looptech-ai.github.io/understand-quickly/schemas/__fixtures__/gitnexus/real-sample.json",
3131
"description": "Demo entry: a sample GitNexus graph modeled on its own codebase.",
3232
"tags": [
3333
"demo",
@@ -46,7 +46,7 @@
4646
"repo": "demo-code-review-graph",
4747
"default_branch": "main",
4848
"format": "code-review-graph@1",
49-
"graph_url": "https://amacsmith.github.io/understand-quickly/schemas/__fixtures__/code-review-graph/real-sample.json",
49+
"graph_url": "https://looptech-ai.github.io/understand-quickly/schemas/__fixtures__/code-review-graph/real-sample.json",
5050
"description": "Demo entry: a sample code-review-graph export covering files, classes, and tests.",
5151
"tags": [
5252
"demo",

site/add.html

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -164,7 +164,7 @@ <h1>Add your repo</h1>
164164
<p class="copy-status" id="copy-status" aria-live="polite" hidden></p>
165165
<p class="manual-hint">
166166
Prefer a manual PR? Open
167-
<a href="https://github.com/amacsmith/understand-quickly/blob/main/CONTRIBUTING.md" rel="noopener" target="_blank">CONTRIBUTING.md</a>
167+
<a href="https://github.com/looptech-ai/understand-quickly/blob/main/CONTRIBUTING.md" rel="noopener" target="_blank">CONTRIBUTING.md</a>
168168
and add the entry to <code>registry.json</code> directly.
169169
</p>
170170
</form>
@@ -183,7 +183,7 @@ <h2>FAQ</h2>
183183
<summary>Don&rsquo;t want to open a GitHub issue?</summary>
184184
<p>
185185
Click <strong>Copy as JSON for direct PR</strong> above, then open a PR yourself per
186-
<a href="https://github.com/amacsmith/understand-quickly/blob/main/CONTRIBUTING.md" rel="noopener" target="_blank">CONTRIBUTING.md</a>.
186+
<a href="https://github.com/looptech-ai/understand-quickly/blob/main/CONTRIBUTING.md" rel="noopener" target="_blank">CONTRIBUTING.md</a>.
187187
A direct PR is usually faster than an issue.
188188
</p>
189189
</details>
@@ -198,7 +198,7 @@ <h2>FAQ</h2>
198198
</main>
199199

200200
<footer class="site-footer">
201-
<span>MIT &middot; <a href="https://github.com/amacsmith/understand-quickly" rel="noopener">source</a></span>
201+
<span>MIT &middot; <a href="https://github.com/looptech-ai/understand-quickly" rel="noopener">source</a></span>
202202
</footer>
203203
</div>
204204

0 commit comments

Comments
 (0)