Skip to content

Open source alternative to Semrush and Ahrefs

Hide SAM from the UI and fix vite dev on fresh checkouts (#795)

Ben Senescudb8bde17e245
diff --git a/.agents/skills/seo-project-setup/SKILL.md b/.agents/skills/seo-project-setup/SKILL.md
index 8ef9b34a..1f43ec0c 100644
--- a/.agents/skills/seo-project-setup/SKILL.md
+++ b/.agents/skills/seo-project-setup/SKILL.md
@@ -7,7 +7,7 @@ description: Populate a project's shared OpenSEO context — site scope, goals,
## Goal
-Interview the user once about one website or SEO project, and store the answers in that project's shared context in OpenSEO with `update_project_context`. That context is read by every other skill, by SAM in the app, and by the user on the project's Context page (in the sidebar under AI) — so it survives new sessions, new machines, and new agents. This is a context setup workflow, not a full audit.
+Interview the user once about one website or SEO project, and store the answers in that project's shared context in OpenSEO with `update_project_context`. That context is read by every other skill and by the user on the project's Context page (in the sidebar under AI) — so it survives new sessions, new machines, and new agents. This is a context setup workflow, not a full audit.
## Tone
diff --git a/.env.example b/.env.example
index 5d05cb10..65a17006 100644
--- a/.env.example
+++ b/.env.example
@@ -39,10 +39,6 @@
# LOOPS_TRANSACTIONAL_RESET_PASSWORD_ID=replace-with-your-loops-reset-template-id
# LOOPS_TRANSACTIONAL_INVITATION_ID=replace-with-your-loops-invitation-template-id
-# Optional in self-hosted modes. Required if you want AI features like SAM,
-# the in-app SEO agent. Create a key at https://openrouter.ai/settings/keys.
-# OPENROUTER_API_KEY=replace-with-your-openrouter-api-key
-
# Optional in self-hosted modes. Required if you want Google Search Console
# integration and MCP tools. BETTER_AUTH_SECRET is also required for GSC (it
# encrypts the stored OAuth tokens). See docs/SELF_HOSTING_GOOGLE_SEARCH_CONSOLE.md.
diff --git a/docs/SELF_HOSTING_DOCKER.md b/docs/SELF_HOSTING_DOCKER.md
index 0fab7d8e..78ff326f 100644
--- a/docs/SELF_HOSTING_DOCKER.md
+++ b/docs/SELF_HOSTING_DOCKER.md
@@ -33,7 +33,6 @@ Optional env values:
- `ALLOWED_HOST` (single reverse-proxy hostname to allow in Vite preview)
- `AUTH_MODE=local_noauth` (already set in compose)
- `OPEN_SEO_IMAGE` (defaults to `ghcr.io/every-app/open-seo:latest`)
-- `OPENROUTER_API_KEY` (required for AI features such as SAM; see [OpenRouter](https://openrouter.ai/settings/keys))
If you are putting Docker behind a reverse proxy or a temporary tunnel, remember that Docker self-hosting runs with app auth disabled. Only expose it behind your own auth-protected reverse proxy, tunnel, or private network, and add the public hostname before restarting:
diff --git a/plugins/openseo/skills/seo-project-setup/SKILL.md b/plugins/openseo/skills/seo-project-setup/SKILL.md
index 8ef9b34a..1f43ec0c 100644
--- a/plugins/openseo/skills/seo-project-setup/SKILL.md
+++ b/plugins/openseo/skills/seo-project-setup/SKILL.md
@@ -7,7 +7,7 @@ description: Populate a project's shared OpenSEO context — site scope, goals,
## Goal
-Interview the user once about one website or SEO project, and store the answers in that project's shared context in OpenSEO with `update_project_context`. That context is read by every other skill, by SAM in the app, and by the user on the project's Context page (in the sidebar under AI) — so it survives new sessions, new machines, and new agents. This is a context setup workflow, not a full audit.
+Interview the user once about one website or SEO project, and store the answers in that project's shared context in OpenSEO with `update_project_context`. That context is read by every other skill and by the user on the project's Context page (in the sidebar under AI) — so it survives new sessions, new machines, and new agents. This is a context setup workflow, not a full audit.
## Tone
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 30a0597f..96950f0f 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -44,7 +44,7 @@ importers:
'@better-auth/api-key':
specifier: 1.6.22
- version: 1.6.22(310ac974949f26c98ba22bd1fe4f0948)
+ version: 1.6.22(7530768a644f5b2a9adacaa9c5c09e9e)
'@cloudflare/think':
specifier: 0.17.0
@@ -95,10 +95,10 @@ importers:
version: 6.0.199([email protected])
autumn-js:
specifier: ^1.2.33
better-auth:
specifier: ^1.6.22
class-variance-authority:
specifier: ^0.7.1
version: 0.7.1
@@ -204,7 +204,7 @@ importers:
'@tanstack/react-devtools':
specifier: ^0.10.12
'@types/node':
specifier: ^22.18.13
version: 22.19.11
@@ -5948,8 +5948,8 @@ packages:
resolution: {integrity: sha512-e0VyvkVTwVYViNovRkZ9aodhxVlyoMn7eJhVUPxZ+eK9P/7CBkxvvsBOHqFPEH416726W8tLXXXjKwqgTErrCQ==}
engines: {node: '>= 10.0.0', npm: '>= 3.0.0'}
- resolution: {integrity: sha512-WEJtcc5mkh/BnHA6Yrg4whlF8g6QwpmXXRg4P2ztPmcKeHHlH4+djYecBLhSpecZY2RRECXYUwIc/C2r3yzQ4Q==}
+ resolution: {integrity: sha512-EeiY2xfpZJqPLjXspVEKjAII4yv8NyG//NxZ3IpOFHdUNnnTyL0uJOeS9LWGvA7cFCz5y94cjFwYlmw5Luncsg==}
resolution: {integrity: sha512-UM/ByIoFra8yzV75n1o0Puu0bw5U/9UNnDacrJNspekBewIfsQ3D6ez1nvlWpt7aTsO6rujQtifBpycwIivqlg==}
@@ -7257,11 +7257,11 @@ snapshots:
optionalDependencies:
'@types/react': 19.2.14
- '@better-auth/[email protected](310ac974949f26c98ba22bd1fe4f0948)':
+ '@better-auth/[email protected](7530768a644f5b2a9adacaa9c5c09e9e)':
dependencies:
'@better-auth/utils': 0.4.2
better-call: 1.3.7([email protected])
zod: 4.4.3
@@ -8166,10 +8166,10 @@ snapshots:
'@neodrag/[email protected]': {}
dependencies:
'@neodrag/core': 3.0.0-next.11
- solid-js: 1.9.11
+ solid-js: 1.9.15
'@neon-rs/[email protected]': {}
@@ -8667,39 +8667,39 @@ snapshots:
'@smithy/util-buffer-from': 2.2.0
tslib: 2.8.1
- '@solid-primitives/[email protected]([email protected])':
+ '@solid-primitives/[email protected]([email protected])':
dependencies:
- '@solid-primitives/utils': 6.4.0([email protected])
- solid-js: 1.9.11
+ '@solid-primitives/utils': 6.4.0([email protected])
+ solid-js: 1.9.15
- '@solid-primitives/[email protected]([email protected])':
+ '@solid-primitives/[email protected]([email protected])':
dependencies:
- '@solid-primitives/event-listener': 2.4.5([email protected])
- '@solid-primitives/rootless': 1.5.3([email protected])
- '@solid-primitives/utils': 6.4.0([email protected])
- solid-js: 1.9.11
+ '@solid-primitives/event-listener': 2.4.5([email protected])
+ '@solid-primitives/rootless': 1.5.3([email protected])
+ '@solid-primitives/utils': 6.4.0([email protected])
+ solid-js: 1.9.15
- '@solid-primitives/[email protected]([email protected])':
+ '@solid-primitives/[email protected]([email protected])':
dependencies:
- '@solid-primitives/event-listener': 2.4.5([email protected])
- '@solid-primitives/rootless': 1.5.3([email protected])
- '@solid-primitives/static-store': 0.1.3([email protected])
- '@solid-primitives/utils': 6.4.0([email protected])
- solid-js: 1.9.11
+ '@solid-primitives/event-listener': 2.4.5([email protected])
+ '@solid-primitives/rootless': 1.5.3([email protected])
+ '@solid-primitives/static-store': 0.1.3([email protected])
+ '@solid-primitives/utils': 6.4.0([email protected])
+ solid-js: 1.9.15
- '@solid-primitives/[email protected]([email protected])':
+ '@solid-primitives/[email protected]([email protected])':
dependencies:
- '@solid-primitives/utils': 6.4.0([email protected])
- solid-js: 1.9.11
+ '@solid-primitives/utils': 6.4.0([email protected])
+ solid-js: 1.9.15
- '@solid-primitives/[email protected]([email protected])':
+ '@solid-primitives/[email protected]([email protected])':
dependencies:
- '@solid-primitives/utils': 6.4.0([email protected])
- solid-js: 1.9.11
+ '@solid-primitives/utils': 6.4.0([email protected])
+ solid-js: 1.9.15
- '@solid-primitives/[email protected]([email protected])':
+ '@solid-primitives/[email protected]([email protected])':
dependencies:
- solid-js: 1.9.11
+ solid-js: 1.9.15
'@speed-highlight/[email protected]': {}
@@ -8858,12 +8858,12 @@ snapshots:
'@tanstack/[email protected]': {}
dependencies:
clsx: 2.1.1
dayjs: 1.11.21
goober: 2.1.19([email protected])
- solid-js: 1.9.11
+ solid-js: 1.9.15
transitivePeerDependencies:
- csstype
@@ -8885,19 +8885,19 @@ snapshots:
- supports-color
- utf-8-validate
dependencies:
'@neodrag/core': 3.0.0-next.11
- '@neodrag/solid': 3.0.0-next.11(@neodrag/[email protected])([email protected])
- '@solid-primitives/event-listener': 2.4.5([email protected])
- '@solid-primitives/keyboard': 1.3.5([email protected])
- '@solid-primitives/resize-observer': 2.1.5([email protected])
+ '@neodrag/solid': 3.0.0-next.11(@neodrag/[email protected])([email protected])
+ '@solid-primitives/event-listener': 2.4.5([email protected])
+ '@solid-primitives/keyboard': 1.3.5([email protected])
+ '@solid-primitives/resize-observer': 2.1.5([email protected])
'@tanstack/devtools-client': 0.0.8
'@tanstack/devtools-event-bus': 0.4.3
- '@tanstack/devtools-ui': 0.7.1([email protected])([email protected])
+ '@tanstack/devtools-ui': 0.7.1([email protected])([email protected])
clsx: 2.1.1
goober: 2.1.19([email protected])
- solid-js: 1.9.11
+ solid-js: 1.9.15
transitivePeerDependencies:
- bufferutil
- csstype
@@ -8915,9 +8915,9 @@ snapshots:
'@tanstack/[email protected]': {}
dependencies:
- '@tanstack/devtools': 0.14.2([email protected])([email protected])
+ '@tanstack/devtools': 0.14.2([email protected])([email protected])
'@types/react': 19.2.14
'@types/react-dom': 19.2.3(@types/[email protected])
react: 19.2.4
@@ -9564,13 +9564,13 @@ snapshots:
dependencies:
query-string: 9.3.1
rou3: 0.6.3
zod: 4.3.6
optionalDependencies:
better-call: 1.3.7([email protected])
express: 5.2.1
hono: 4.13.7
@@ -9603,7 +9603,7 @@ snapshots:
dependencies:
@@ -9631,7 +9631,7 @@ snapshots:
pg: 8.22.0
react: 19.2.4
react-dom: 19.2.4([email protected])
- solid-js: 1.9.11
+ solid-js: 1.9.15
transitivePeerDependencies:
- '@cloudflare/workers-types'
@@ -12435,7 +12435,7 @@ snapshots:
ip-address: 10.7.2
smart-buffer: 4.2.0
dependencies:
csstype: 3.2.3
seroval: 1.5.6
diff --git a/src/client/components/Sidebar.tsx b/src/client/components/Sidebar.tsx
index e6c3224a..f48aba99 100644
--- a/src/client/components/Sidebar.tsx
+++ b/src/client/components/Sidebar.tsx
@@ -1,16 +1,14 @@
-import { Link, useLocation, useNavigate } from "@tanstack/react-router";
+import { Link, useLocation } from "@tanstack/react-router";
import type { LinkOptions } from "@tanstack/react-router";
import { useQuery } from "@tanstack/react-query";
-import { useEffect, useState, type ComponentType } from "react";
+import { useState, type ComponentType } from "react";
import { toast } from "sonner";
import {
ArrowLeftRight,
Check,
CircleHelp,
CreditCard,
- LayoutGrid,
LogOut,
- MessageCircle,
Settings,
User,
} from "lucide-react";
@@ -43,7 +41,6 @@ import {
SidebarMenuSkeleton,
useSidebar,
} from "@/client/components/ui/sidebar";
-import { Tabs, TabsList, TabsTrigger } from "@/client/components/ui/tabs";
import {
DropdownMenu,
DropdownMenuContent,
@@ -121,38 +118,11 @@ export function Sidebar({
projectId !== null || navPlaceholder
? getProjectNavGroups(projectId ?? "")
: [connectNavGroup];
- const navigate = useNavigate();
const { pathname } = useLocation();
const { setOpenMobile } = useSidebar();
+ // SAM is hidden from navigation: the chat route is only reachable by URL,
+ // and while it is open its chat list takes the nav's place.
const onSamRoute = pathname.includes("/sam");
- const [view, setView] = useState<"browse" | "chat">(
- onSamRoute ? "chat" : "browse",
- );
-
- useEffect(() => {
- setView(onSamRoute ? "chat" : "browse");
- }, [onSamRoute]);
-
- const openChat = (activeProjectId: string) => {
- setView("chat");
- if (onSamRoute) return;
- void navigate({
- to: "/p/$projectId/sam",
- params: { projectId: activeProjectId },
- search: {},
- });
- setOpenMobile(false);
- };
-
- const openBrowse = (activeProjectId: string) => {
- setView("browse");
- if (!onSamRoute) return;
- void navigate({
- to: "/p/$projectId",
- params: { projectId: activeProjectId },
- });
- setOpenMobile(false);
- };
return (
<UiSidebar variant="inset" collapsible="offcanvas" className="md:!p-0">
@@ -169,32 +139,10 @@ export function Sidebar({
ready={ready}
onCloseDrawer={() => setOpenMobile(false)}
/>
- {projectId !== null || navPlaceholder ? (
- <Tabs
- value={view}
- onValueChange={(value) => {
- if (projectId === null) return;
- if (value === "chat") openChat(projectId);
- else openBrowse(projectId);
- }}
- className="pt-2"
- >
- <TabsList variant="line" className="w-full">
- <TabsTrigger value="browse">
- <LayoutGrid className="size-4" />
- Browse
- </TabsTrigger>
- <TabsTrigger value="chat">
- <MessageCircle className="size-4" />
- Chat
- </TabsTrigger>
- </TabsList>
- </Tabs>
- ) : null}
</SidebarHeader>
<SidebarContent>
- {view === "chat" && projectId ? (
+ {onSamRoute && projectId ? (
ready ? (
<SamSidebarPanel
projectId={projectId}
diff --git a/src/client/features/projects/project-context/CompetitorsSection.tsx b/src/client/features/projects/project-context/CompetitorsSection.tsx
index e80d85c7..b4e4d2b4 100644
--- a/src/client/features/projects/project-context/CompetitorsSection.tsx
+++ b/src/client/features/projects/project-context/CompetitorsSection.tsx
@@ -44,7 +44,7 @@ export function CompetitorsSection({
hint="The sites you measure yourself against."
addLabel="Add competitor"
emptyTitle="No competitors yet"
- emptyDescription="Add the sites you compete with, or ask SAM to find them from your rankings and save them here."
+ emptyDescription="Add the sites you compete with, or ask your agent to find them from your rankings and save them here."
items={competitors}
getId={(item) => item.id}
getLabel={(item) => item.domain}
diff --git a/src/client/features/projects/project-context/ProjectContextPage.tsx b/src/client/features/projects/project-context/ProjectContextPage.tsx
index efc3378f..79ff672b 100644
--- a/src/client/features/projects/project-context/ProjectContextPage.tsx
+++ b/src/client/features/projects/project-context/ProjectContextPage.tsx
@@ -64,7 +64,7 @@ export function ProjectContextPage({ projectId }: { projectId: string }) {
// draft, open form, or edit state can carry over to another project.
<div key={projectId} className="space-y-8">
<p className="text-sm text-muted-foreground">
- What SAM, Claude Code, and any connected MCP client know about this
+ What Claude Code and any other connected MCP client know about this
project. They read it before they work and write back what they
learn, so correct anything that looks wrong.
</p>
@@ -155,7 +155,7 @@ function ProseSections({
size="sm"
icon={null}
title="Nothing written down yet"
- description="Fill in what you can — or ask SAM to draft it from your site and confirm what it got right."
+ description="Fill in what you can — or ask your agent to draft it from your site and confirm what it got right."
/>
) : null}
diff --git a/src/client/features/sam/SamSidebarPanel.tsx b/src/client/features/sam/SamSidebarPanel.tsx
index b1a60d4e..937f5262 100644
--- a/src/client/features/sam/SamSidebarPanel.tsx
+++ b/src/client/features/sam/SamSidebarPanel.tsx
@@ -87,9 +87,9 @@ export function SamChatListSkeleton() {
}
/**
- * The sidebar's Chat tab: the active project's chat history plus a new-chat
- * button. Selecting (or creating) a session navigates to the SAM route; the
- * conversation itself renders in the main content panel.
+ * The sidebar while the SAM route is open: the active project's chat history
+ * plus a new-chat button. Selecting (or creating) a session navigates to the
+ * SAM route; the conversation itself renders in the main content panel.
*/
export function SamSidebarPanel({
projectId,
@@ -122,12 +122,12 @@ export function SamSidebarPanel({
},
});
- // Until the user opts in, the chat route shows SamBetaGate; the tab just
- // points there instead of offering a chat list that can't be used yet.
+ // Until the user opts in, the chat route shows SamBetaGate, so there is no
+ // chat list that can be used yet.
if (!optedIn) {
return (
<p className="px-4 py-6 text-center text-xs text-muted-foreground">
- Sam is in beta and opt-in. Open Chat to read more and decide.
+ Your chats will show here once you opt in to the beta.
</p>
);
}
diff --git a/web/content/docs/self-hosting/index.md b/web/content/docs/self-hosting/index.md
index 943e6214..734688c7 100644
--- a/web/content/docs/self-hosting/index.md
+++ b/web/content/docs/self-hosting/index.md
@@ -29,7 +29,3 @@ New DataForSEO accounts include $1 of free credit to test with, and the minimum
### Google Search Console
Search Console is optional and works in self-hosted deployments using your own Google OAuth client. It takes about 10 minutes of one-time setup. See the [Google Search Console guide on GitHub](https://github.com/every-app/open-seo/blob/main/docs/SELF_HOSTING_GOOGLE_SEARCH_CONSOLE.md).
-
-### AI features (SAM)
-
-AI features like SAM, the in-app SEO agent, are optional. Set the `OPENROUTER_API_KEY` environment variable to enable them. Create a key at [openrouter.ai/settings/keys](https://openrouter.ai/settings/keys).
diff --git a/web/content/docs/skills/seo-project-setup.mdx b/web/content/docs/skills/seo-project-setup.mdx
index ef2b6855..7b4e8fc7 100644
--- a/web/content/docs/skills/seo-project-setup.mdx
+++ b/web/content/docs/skills/seo-project-setup.mdx
@@ -9,7 +9,7 @@ The SEO Project Setup Agent Skill gives your agent the context it needs before d
Your agent asks about the website, goals, positioning, competitors, and key pages once, then saves the answers to your project's context in OpenSEO.
-Every other skill reads that context, so does SAM in the app, and you can edit it yourself on the project's Context page, in the sidebar under AI. It carries across sessions, machines, and agents.
+Every other skill reads that context, and you can edit it yourself on the project's Context page, in the sidebar under AI. It carries across sessions, machines, and agents.
## What this skill helps your agent do