* Rework docs navigation and move alternatives to top-level pages - Add nested docs nav with categories, collapsible groups, breadcrumbs, and a right-hand page outline with heading slugs. - Move alternatives out of /docs/alternatives into /alternatives/* marketing pages with 301 redirects. - Add github-slugger for heading IDs and require explicit width on SiteShell so new pages can't accidentally pick the narrow prose layout. - Remove the best-practices doc from public-docs. * Make docs content column prose-width
69 lines
3.2 KiB
TypeScript
69 lines
3.2 KiB
TypeScript
import { getAlternativePages } from "~/data/alternative-pages";
|
|
import { AGENT_PAGES } from "~/data/agent-pages";
|
|
import { type Doc, getDocs } from "~/docs";
|
|
|
|
const SITE_URL = "https://paseo.sh";
|
|
|
|
const PRODUCT_PREAMBLE = `# Paseo
|
|
|
|
> Mobile and desktop app for monitoring and controlling your local AI coding agents from anywhere. Your dev environment, in your pocket.
|
|
|
|
Paseo is an open source application that lets you run AI coding agents on your own machine and drive them from your phone, desktop, browser, or terminal. Your code stays local — Paseo connects directly to your real development environment instead of running agents in someone else's cloud.
|
|
|
|
A self-hosted daemon manages agent lifecycle, exposes a WebSocket API, and ships with an MCP server so other agents can talk to it. Native apps for iOS, Android, macOS, Windows, Linux, and the web let you launch sessions, watch them work, review diffs, and ship from anywhere. A Docker-style CLI ("paseo run", "paseo ls", "paseo logs", "paseo wait") gives you scripting access. An end-to-end encrypted relay lets the mobile app reach your daemon over the public internet without exposing it.
|
|
|
|
Paseo supports every major coding agent: Claude Code, Codex, GitHub Copilot, OpenCode, Cursor, Gemini, Cline, Goose, Amp, Aider, and 30+ others. Each agent runs as its own process; Paseo handles I/O, persistence, git worktree isolation, schedules, and skills.
|
|
|
|
Distribution: native apps for Mac, Windows, Linux, iOS, and Android; web app; Homebrew; npm. Source: AGPL-3.0 at https://github.com/getpaseo/paseo. Marketing site: https://paseo.sh.
|
|
`;
|
|
|
|
function docLine(doc: Doc): string {
|
|
const url = `${SITE_URL}${doc.href}.md`;
|
|
const description = doc.frontmatter.description?.trim();
|
|
const suffix = description ? `: ${description}` : "";
|
|
return `- [${doc.frontmatter.title}](${url})${suffix}`;
|
|
}
|
|
|
|
function agentLine(agent: (typeof AGENT_PAGES)[number]): string {
|
|
return `- [${agent.name}](${SITE_URL}/${agent.slug}): ${agent.subtitle}`;
|
|
}
|
|
|
|
function alternativeLine(page: ReturnType<typeof getAlternativePages>[number]): string {
|
|
const description = page.description.trim();
|
|
const suffix = description ? `: ${description}` : "";
|
|
return `- [${page.title}](${SITE_URL}${page.href})${suffix}`;
|
|
}
|
|
|
|
function topLevelDocs(): Doc[] {
|
|
return getDocs().filter((d) => !d.slug.includes("/"));
|
|
}
|
|
|
|
export function buildLlmsTxt(): string {
|
|
const docs = topLevelDocs().map(docLine).join("\n");
|
|
const alternatives = getAlternativePages().map(alternativeLine).join("\n");
|
|
const agents = AGENT_PAGES.map(agentLine).join("\n");
|
|
|
|
return `${PRODUCT_PREAMBLE}
|
|
## Docs
|
|
|
|
${docs}
|
|
|
|
## Alternatives
|
|
|
|
${alternatives}
|
|
|
|
## Supported agents
|
|
|
|
${agents}
|
|
|
|
## Optional
|
|
|
|
- [Changelog](${SITE_URL}/changelog): Release notes for the Paseo daemon, CLI, desktop, and mobile apps.
|
|
- [Download](${SITE_URL}/download): Install Paseo on Mac, Windows, Linux, iOS, Android, or run the web app.
|
|
- [Paseo Cloud](${SITE_URL}/cloud): Waitlist for the hosted multi-user version of Paseo.
|
|
- [Blog](${SITE_URL}/blog): Updates and technical posts from the Paseo team.
|
|
- [Privacy](${SITE_URL}/privacy): Privacy policy.
|
|
- [GitHub](https://github.com/getpaseo/paseo): Source code, issues, and releases.
|
|
`;
|
|
}
|