Skip to content

armgit / alook

Public Imported from GitHub
0

Multi-Agent Collaboration for Team and Friends

fix(seo): refine crawl metadata and reduce Blog image bytes (#1166)

Gustavo Ye568d7e896986
diff --git a/src/web/blog/public/blog/ask-coworker-codex-claude-code/context.webp b/src/web/blog/public/blog/ask-coworker-codex-claude-code/context.webp
new file mode 100644
index 000000000..b22967480
Binary files /dev/null and b/src/web/blog/public/blog/ask-coworker-codex-claude-code/context.webp differ
diff --git a/src/web/blog/public/blog/ask-coworker-codex-claude-code/coordination.webp b/src/web/blog/public/blog/ask-coworker-codex-claude-code/coordination.webp
new file mode 100644
index 000000000..144b7337c
Binary files /dev/null and b/src/web/blog/public/blog/ask-coworker-codex-claude-code/coordination.webp differ
diff --git a/src/web/blog/public/blog/ask-coworker-codex-claude-code/hero.webp b/src/web/blog/public/blog/ask-coworker-codex-claude-code/hero.webp
new file mode 100644
index 000000000..cf2da3019
Binary files /dev/null and b/src/web/blog/public/blog/ask-coworker-codex-claude-code/hero.webp differ
diff --git a/src/web/blog/public/blog/ask-coworker-codex-claude-code/patience.webp b/src/web/blog/public/blog/ask-coworker-codex-claude-code/patience.webp
new file mode 100644
index 000000000..e17528e4d
Binary files /dev/null and b/src/web/blog/public/blog/ask-coworker-codex-claude-code/patience.webp differ
diff --git a/src/web/blog/public/blog/ask-coworker-codex-claude-code/roles.webp b/src/web/blog/public/blog/ask-coworker-codex-claude-code/roles.webp
new file mode 100644
index 000000000..9f38a996f
Binary files /dev/null and b/src/web/blog/public/blog/ask-coworker-codex-claude-code/roles.webp differ
diff --git a/src/web/blog/public/blog/ask-coworker-codex-claude-code/tools.webp b/src/web/blog/public/blog/ask-coworker-codex-claude-code/tools.webp
new file mode 100644
index 000000000..f575843d1
Binary files /dev/null and b/src/web/blog/public/blog/ask-coworker-codex-claude-code/tools.webp differ
diff --git a/src/web/blog/src/app/tutorials/page.tsx b/src/web/blog/src/app/tutorials/page.tsx
index 07b3d4344..10648f3ba 100644
--- a/src/web/blog/src/app/tutorials/page.tsx
+++ b/src/web/blog/src/app/tutorials/page.tsx
@@ -4,7 +4,7 @@ import { stepGuides } from "@/lib/step-guides";
import { ObservedStaticContent } from "@/lib/observability/regions";
import { buildPublicPageMetadata } from "@/lib/seo/public-page-metadata";
-const description = "Step-by-step tutorials to connect your agents and start working together in Alook.";
+const description = "Connect the coding agents on your computer to Alook. Follow tutorials to create bots, invite them to a shared server, and start a conversation.";
export const metadata = buildPublicPageMetadata({ title: "Tutorials — Alook", description, path: "/tutorials" });
export default function TutorialsPage() {
diff --git a/src/web/blog/src/content/ask-coworker-codex-claude-code.mdx b/src/web/blog/src/content/ask-coworker-codex-claude-code.mdx
index 50012a0f5..c4cc5bade 100644
--- a/src/web/blog/src/content/ask-coworker-codex-claude-code.mdx
+++ b/src/web/blog/src/content/ask-coworker-codex-claude-code.mdx
@@ -5,10 +5,10 @@ export const metadata = {
author: "Gus",
excerpt: "Codex and Claude Code stay on your computer. The bot has an account. A coworker can ask what you did, and your bot can ask theirs, without pasting the session.",
readingTime: "8 min read",
- image: "/blog/ask-coworker-codex-claude-code/hero.png",
+ image: "/blog/ask-coworker-codex-claude-code/hero.webp",
};
-![People and their bots walking into the same shared workspace](/blog/ask-coworker-codex-claude-code/hero.png)
+![People and their bots walking into the same shared workspace](/blog/ask-coworker-codex-claude-code/hero.webp)
You, your coworkers, and your friends might all be using Codex or Claude Code for work or everyday tasks.
@@ -26,7 +26,7 @@ I think it's worth a few minutes to look at what we built on alook.ai. Five reas
## Stop carrying context back and forth
-![Bots exchanging context directly, so people stop carrying the material](/blog/ask-coworker-codex-claude-code/context.png)
+![Bots exchanging context directly, so people stop carrying the material](/blog/ask-coworker-codex-claude-code/context.webp)
Do any of these sound like you?
@@ -53,7 +53,7 @@ In Alook, a bot that was part of the work has an account, and I can go ask it. I
## From managing sessions to managing roles
-![Cecilia learning during a real review and keeping what the role has learned](/blog/ask-coworker-codex-claude-code/roles.png)
+![Cecilia learning during a real review and keeping what the role has learned](/blog/ask-coworker-codex-claude-code/roles.webp)
You might have a few sessions open: one changing code, one looking things up, one reviewing a proposal. The development requirements are in one; the review standards are in another. The next task starts in a new chat, and you have to explain the requirements again.
@@ -73,7 +73,7 @@ For the next proposal, I still go to Cecilia. She can check her memory and conti
## Multiple bots mean less attention
-![Bots moving the work themselves through a channel, a forum post, and a DM](/blog/ask-coworker-codex-claude-code/coordination.png)
+![Bots moving the work themselves through a channel, a forum post, and a DM](/blog/ask-coworker-codex-claude-code/coordination.webp)
If I split implementation and review across a few bots, but they each sit in separate chats waiting for me to assign the next step, I still have to pass along proposals and comments, and remind someone to continue. I've handed off the work, but I'm still stuck between the steps.
@@ -87,7 +87,7 @@ When I come back to the post, I can see how the proposal changed and why. If the
## Don't get locked to one harness or model
-![The same bot keeping its memory while switching tools](/blog/ask-coworker-codex-claude-code/tools.png)
+![The same bot keeping its memory while switching tools](/blog/ask-coworker-codex-claude-code/tools.webp)
Teaching Cecilia how to review a proposal already took my time. Models and tools change fast. I like Codex today. Later I may want Claude Code. If those requirements live only in some session of the old tool, I have to explain them again after I switch. I end up staying on the old tool because I don't want to lose what we've built up.
@@ -99,7 +99,7 @@ Tools and models still behave differently. The requirements we've already made c
## Bots are better humans
-![Asking a bot to check the record, and to separate facts from what is still open](/blog/ask-coworker-codex-claude-code/patience.png)
+![Asking a bot to check the record, and to separate facts from what is still open](/blog/ask-coworker-codex-claude-code/patience.webp)
When I want to understand a problem, a conclusion often isn't enough. I want to keep asking where the evidence is, what is already confirmed, and what is still a guess. If the other person is busy, they may not have time to go through all those details with me.
diff --git a/src/web/blog/src/content/claude-code-codex-cursor-grok-which-to-choose.mdx b/src/web/blog/src/content/claude-code-codex-cursor-grok-which-to-choose.mdx
index 7a2e46092..8186bbc52 100644
--- a/src/web/blog/src/content/claude-code-codex-cursor-grok-which-to-choose.mdx
+++ b/src/web/blog/src/content/claude-code-codex-cursor-grok-which-to-choose.mdx
@@ -3,7 +3,7 @@ export const metadata = {
title: "Claude Code, Codex, Cursor, or Grok: which should I choose?",
date: "2026-10-27",
author: "Alook Team",
- excerpt: "We analyzed 3,283 X posts to compare Claude Code, Codex, Cursor, Grok Bot, Grok Build, Antigravity and OpenCode. Here is which harness to try for your next task.",
+ excerpt: "We analyzed 3,283 X posts about seven agents. Compare Claude Code, Codex, Cursor, Grok, Antigravity, and OpenCode by the jobs people used them for.",
readingTime: "5 min read",
image: "/blog/claude-code-codex-cursor-grok-which-to-choose/agent-feedback.png",
};
diff --git a/src/web/blog/src/content/cursor-vs-claude-code.mdx b/src/web/blog/src/content/cursor-vs-claude-code.mdx
index 1f01cb6a8..58e2c94ba 100644
--- a/src/web/blog/src/content/cursor-vs-claude-code.mdx
+++ b/src/web/blog/src/content/cursor-vs-claude-code.mdx
@@ -1,6 +1,7 @@
export const metadata = {
slug: "cursor-vs-claude-code",
title: "Cursor vs Claude Code (2026): Strengths, Limits, and Using Both",
+ seoTitle: "Cursor vs Claude Code (2026): Compare and Use Both",
date: "2026-11-02",
author: "Alook Team",
excerpt: "Cursor vs Claude Code: compare coding strengths, models, prices, and usage limits in 2026, then see how to use both with shared project rules.",
diff --git a/src/web/blog/src/content/how-to-build-liquid-software.mdx b/src/web/blog/src/content/how-to-build-liquid-software.mdx
index fd43934ed..eddeac6cd 100644
--- a/src/web/blog/src/content/how-to-build-liquid-software.mdx
+++ b/src/web/blog/src/content/how-to-build-liquid-software.mdx
@@ -3,7 +3,7 @@ export const metadata = {
title: "How to build liquid software",
date: "2026-11-02",
author: "Alook Team",
- excerpt: "Patrick Collison calls it liquid software: users ask, an agent changes the code. It needs a user community where your coding agent can listen, and Alook gives it one.",
+ excerpt: "Patrick Collison’s liquid software lets users ask an agent to change an app. See how a user community helps makers hear requests and review shared changes.",
readingTime: "8 min read",
image: "/blog/how-to-build-liquid-software/01-liquid-software.webp",
};
diff --git a/src/web/blog/src/lib/blog/image-assets.json b/src/web/blog/src/lib/blog/image-assets.json
index 18ab032f8..a38d5560d 100644
--- a/src/web/blog/src/lib/blog/image-assets.json
+++ b/src/web/blog/src/lib/blog/image-assets.json
@@ -25,12 +25,12 @@
"/blog/alook-vs-buzz/work-records.webp": {"width":1200,"height":1200,"srcSet":"/blog/_generated/c7ebb313a0a787ed-480.webp 480w, /blog/_generated/c7ebb313a0a787ed-960.webp 960w, /blog/alook-vs-buzz/work-records.webp 1200w"},
"/blog/alook-vs-grok-bot/hero.webp": {"width":1200,"height":630,"srcSet":"/blog/_generated/0ad07ea283c60e4b-480.webp 480w, /blog/_generated/0ad07ea283c60e4b-960.webp 960w, /blog/alook-vs-grok-bot/hero.webp 1200w"},
"/blog/alook-vs-grok-bot/sharing.webp": {"width":1200,"height":1200,"srcSet":"/blog/_generated/4c548f58ddd99181-480.webp 480w, /blog/_generated/4c548f58ddd99181-960.webp 960w, /blog/alook-vs-grok-bot/sharing.webp 1200w"},
- "/blog/ask-coworker-codex-claude-code/context.png": {"width":1672,"height":941,"srcSet":"/blog/_generated/5c7203e6e1ad3768-480.webp 480w, /blog/_generated/5c7203e6e1ad3768-960.webp 960w, /blog/ask-coworker-codex-claude-code/context.png 1672w"},
- "/blog/ask-coworker-codex-claude-code/coordination.png": {"width":1672,"height":941,"srcSet":"/blog/_generated/1839b58d2235b47c-480.webp 480w, /blog/_generated/1839b58d2235b47c-960.webp 960w, /blog/ask-coworker-codex-claude-code/coordination.png 1672w"},
- "/blog/ask-coworker-codex-claude-code/hero.png": {"width":1672,"height":941,"srcSet":"/blog/_generated/83f206dd9ba16900-480.webp 480w, /blog/_generated/83f206dd9ba16900-960.webp 960w, /blog/ask-coworker-codex-claude-code/hero.png 1672w"},
- "/blog/ask-coworker-codex-claude-code/patience.png": {"width":1672,"height":941,"srcSet":"/blog/_generated/62fc3a054067e6b9-480.webp 480w, /blog/_generated/62fc3a054067e6b9-960.webp 960w, /blog/ask-coworker-codex-claude-code/patience.png 1672w"},
- "/blog/ask-coworker-codex-claude-code/roles.png": {"width":1672,"height":941,"srcSet":"/blog/_generated/221028dcf5df8a5e-480.webp 480w, /blog/_generated/221028dcf5df8a5e-960.webp 960w, /blog/ask-coworker-codex-claude-code/roles.png 1672w"},
- "/blog/ask-coworker-codex-claude-code/tools.png": {"width":1672,"height":941,"srcSet":"/blog/_generated/7e81c2bfd9bf1d5e-480.webp 480w, /blog/_generated/7e81c2bfd9bf1d5e-960.webp 960w, /blog/ask-coworker-codex-claude-code/tools.png 1672w"},
+ "/blog/ask-coworker-codex-claude-code/context.webp": {"width":1672,"height":941,"srcSet":"/blog/_generated/1286a2ee29ecb47a-480.webp 480w, /blog/_generated/1286a2ee29ecb47a-960.webp 960w, /blog/ask-coworker-codex-claude-code/context.webp 1672w"},
+ "/blog/ask-coworker-codex-claude-code/coordination.webp": {"width":1672,"height":941,"srcSet":"/blog/_generated/e801a26221cdb6de-480.webp 480w, /blog/_generated/e801a26221cdb6de-960.webp 960w, /blog/ask-coworker-codex-claude-code/coordination.webp 1672w"},
+ "/blog/ask-coworker-codex-claude-code/hero.webp": {"width":1672,"height":941,"srcSet":"/blog/_generated/918178dad5d9b8e2-480.webp 480w, /blog/_generated/918178dad5d9b8e2-960.webp 960w, /blog/ask-coworker-codex-claude-code/hero.webp 1672w"},
+ "/blog/ask-coworker-codex-claude-code/patience.webp": {"width":1672,"height":941,"srcSet":"/blog/_generated/2aba084122cb8b7e-480.webp 480w, /blog/_generated/2aba084122cb8b7e-960.webp 960w, /blog/ask-coworker-codex-claude-code/patience.webp 1672w"},
+ "/blog/ask-coworker-codex-claude-code/roles.webp": {"width":1672,"height":941,"srcSet":"/blog/_generated/af41ea6ee35ddc73-480.webp 480w, /blog/_generated/af41ea6ee35ddc73-960.webp 960w, /blog/ask-coworker-codex-claude-code/roles.webp 1672w"},
+ "/blog/ask-coworker-codex-claude-code/tools.webp": {"width":1672,"height":941,"srcSet":"/blog/_generated/18df8adee2139ba8-480.webp 480w, /blog/_generated/18df8adee2139ba8-960.webp 960w, /blog/ask-coworker-codex-claude-code/tools.webp 1672w"},
"/blog/claude-code-and-codex-same-team/handoff-20261015.png": {"width":800,"height":1024,"srcSet":"/blog/_generated/f8d73ec8dd1a8a03-480.webp 480w, /blog/claude-code-and-codex-same-team/handoff-20261015.png 800w"},
"/blog/claude-code-and-codex-same-team/hero.webp": {"width":1200,"height":630,"srcSet":"/blog/_generated/d533b2f3c720a020-480.webp 480w, /blog/_generated/d533b2f3c720a020-960.webp 960w, /blog/claude-code-and-codex-same-team/hero.webp 1200w"},
"/blog/claude-code-and-codex-same-team/machines-ui-20261015.png": {"width":1280,"height":720,"srcSet":"/blog/_generated/436fe30ed16a98d1-480.webp 480w, /blog/_generated/436fe30ed16a98d1-960.webp 960w, /blog/claude-code-and-codex-same-team/machines-ui-20261015.png 1280w"},
diff --git a/src/web/src/lib/root-sitemap.test.ts b/src/web/src/lib/root-sitemap.test.ts
index e1841a103..e248ab047 100644
--- a/src/web/src/lib/root-sitemap.test.ts
+++ b/src/web/src/lib/root-sitemap.test.ts
@@ -45,6 +45,7 @@ describe("sitemap", () => {
expect(urls.filter(url => url.startsWith("https://alook.ai/tutorials/"))).toEqual(stepGuides.map(guide => `https://alook.ai/tutorials/${guide.slug}`));
expect(urls).not.toContain("https://alook.ai/guides/codex-and-claude-code");
expect(urls).toContain("https://alook.ai/privacy");
+ expect(urls).toContain("https://alook.ai/terms");
expect(urls).toContain("https://alook.ai/blog/revised");
expect(urls).not.toContain("https://alook.ai/sign-in");
expect(urls).not.toContain("https://alook.ai/llms.txt");
@@ -94,6 +95,7 @@ describe("sitemap", () => {
expect(urls).not.toContain("https://alook.ai/blog");
expect(urls).not.toContain("https://alook.ai/guides");
expect(urls).toContain("https://alook.ai/privacy");
+ expect(urls).toContain("https://alook.ai/terms");
});
it("includes an undated Blog index for an empty discovery manifest", () => {
diff --git a/src/web/src/lib/root-sitemap.ts b/src/web/src/lib/root-sitemap.ts
index 023862d8b..eb5f42de8 100644
--- a/src/web/src/lib/root-sitemap.ts
+++ b/src/web/src/lib/root-sitemap.ts
@@ -43,6 +43,7 @@ export function buildRootSitemap(manifest: BlogDiscoveryManifestV1 | null): Meta
...blogEntries,
{ url: `${SITE_URL}/contact`, changeFrequency: "monthly", priority: 0.5 },
{ url: `${SITE_URL}/privacy`, changeFrequency: "yearly", priority: 0.3 },
+ { url: `${SITE_URL}/terms`, changeFrequency: "yearly", priority: 0.3 },
];
}
diff --git a/src/web/src/lib/step-guides.ts b/src/web/src/lib/step-guides.ts
index 1966f0649..d870c0855 100644
--- a/src/web/src/lib/step-guides.ts
+++ b/src/web/src/lib/step-guides.ts
@@ -25,7 +25,7 @@ type GuideDefinition = {
const definitions: readonly GuideDefinition[] = [
{
slug: "codex-and-claude-code", agents: defaultTutorialPair, date: "2026-10-27",
- description: "Connect your computer, create Codex and Claude Code bots, and bring them into one Alook server.",
+ description: "Connect your computer to Alook, create Codex and Claude Code bots, invite them to the same server, and give both agents a task in one shared channel.",
connectLead: "Connect the computer where Codex and Claude Code are installed.",
firstBotLead: "Start with Codex. The example names this bot Milo.",
secondBotLead: "Add Claude Code as your second bot. The example names it Nova.",