Skip to content

Commit feecd3c

Browse files
web3dev1337web3dev1337
authored
Merge pull request #922 from web3dev1337/feat/llm-seo-deep-research
feat: improve website and README for LLM/SEO discovery
2 parents f08acd1 + f131916 commit feecd3c

9 files changed

Lines changed: 237 additions & 3 deletions

File tree

‎CODEBASE_DOCUMENTATION.md‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -364,6 +364,10 @@ site/ - Concise product/showcase site kept separate
364364
├─ index.html - Single-page product overview and quick-start narrative
365365
├─ terms.html - Generated public Terms of Use page linked from footer + install/download flows
366366
├─ privacy.html - Generated public Privacy Policy page linked from footer + install/download flows
367+
├─ robots.txt - Crawl policy for search/AI bots + sitemap declaration
368+
├─ sitemap.xml - Canonical URL inventory for core public pages
369+
├─ llms.txt - Short AI-oriented summary + canonical product links
370+
├─ llms-full.txt - Extended AI-oriented product details for retrieval/chat assistants
367371
├─ styles.css - Showcase visual system, layout, and motion
368372
├─ script.js - Small reveal-on-scroll enhancement
369373
├─ assets/ - Favicon, provider logos, generated Open Graph preview, and real UI screenshot

‎README.md‎

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,32 @@ All your Agents. One Workspace.
1010

1111
Run multiple CLI agents in parallel across different repos. Your hardware, your plans, your API keys. No publisher-hosted telemetry by default.
1212

13+
## What Agent Workspace Is
14+
15+
Agent Workspace is a local-first orchestration layer for CLI coding agents.
16+
17+
- **Control plane for agent CLIs** — Run Claude Code, Codex CLI, Gemini CLI, OpenCode, and other terminal-based agents in one UI.
18+
- **Multi-repo and multi-worktree execution** — Keep multiple repositories and branches active side by side.
19+
- **Review + runtime workflow** — Pair agent windows with server windows, then jump directly to GitHub diffs and PRs.
20+
21+
## Runs Locally vs Models by Provider
22+
23+
- **Runs locally:** sessions, workspaces, worktrees, orchestration state.
24+
- **Runs via provider accounts:** model inference through your selected AI CLI/provider accounts.
25+
- **No platform-managed model relay:** you choose provider and account context.
26+
27+
## Quick Answers
28+
29+
- **Does Agent Workspace run locally?** Yes, orchestration and sessions run on your machine.
30+
- **Can I use multiple repositories at once?** Yes, one workspace can include one or many repositories.
31+
- **Can I run server processes in the same worktree?** Yes, agent and server windows can run side by side.
32+
- **Can I jump straight to GitHub review pages?** Yes, the review flow supports direct links to GitHub PRs and diffs.
33+
34+
## Discovery Files
35+
36+
- Website AI index: [agent-workspace.ai/llms.txt](https://agent-workspace.ai/llms.txt)
37+
- Extended AI index: [agent-workspace.ai/llms-full.txt](https://agent-workspace.ai/llms-full.txt)
38+
1339
## Product Screenshots
1440

1541
### Main Workspace View
@@ -41,8 +67,11 @@ Agent Workspace wraps your preferred terminal tools and runs them side by side w
4167
- Codex CLI
4268
- Gemini CLI
4369
- OpenCode
70+
- Grok CLI
4471
- Any CLI agent that runs in a terminal
4572

73+
Compatibility rule: if it can be launched from a terminal command in your worktree, Agent Workspace can run it.
74+
4675
**Works with:** Claude Max, Codex plans, or your own API keys.
4776

4877
## Features

‎site/README.md‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,12 @@ The preview server serves `site/` on `http://127.0.0.1:4173` by default.
1616

1717
`site/assets/og-card.svg` is the editable social card source, and `site/assets/og-card.png` is the generated preview image referenced by the page metadata.
1818

19+
## Crawl and discovery files
20+
21+
- `site/robots.txt` defines crawl policy and points to the sitemap.
22+
- `site/sitemap.xml` lists canonical public URLs.
23+
- `site/llms.txt` and `site/llms-full.txt` provide concise and extended AI-readable summaries.
24+
1925
## Why this is not wired to GitHub Pages yet
2026

2127
GitHub's current Pages documentation says private Pages access control is available for organization-owned sites on GitHub Enterprise Cloud. Since this repository still contains internal documentation and private-only materials, the showcase source is isolated here but deployment is intentionally not enabled yet.

‎site/index.html‎

Lines changed: 50 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,8 @@
55
<meta name="viewport" content="width=device-width, initial-scale=1.0">
66
<title>Agent Workspace | All Your Agents, One Workspace</title>
77
<meta name="description" content="Run multiple CLI agents in parallel across repos with full local control. Agent Workspace runs locally; model inference runs through the providers and CLIs you choose.">
8+
<meta name="robots" content="index,follow,max-image-preview:large,max-snippet:-1,max-video-preview:-1">
9+
<link rel="canonical" href="https://agent-workspace.ai/">
810

911
<!-- Open Graph -->
1012
<meta property="og:type" content="website">
@@ -20,6 +22,35 @@
2022
<meta name="twitter:description" content="Run multiple CLI agents in parallel across repos. Agent Workspace runs locally on your machine, while model requests use your selected providers and CLI accounts.">
2123
<meta name="twitter:image" content="https://agent-workspace.ai/assets/og-card.png">
2224

25+
<script type="application/ld+json">
26+
{
27+
"@context": "https://schema.org",
28+
"@type": "SoftwareApplication",
29+
"name": "Agent Workspace",
30+
"applicationCategory": "DeveloperApplication",
31+
"operatingSystem": "Windows, macOS, Linux, Web",
32+
"url": "https://agent-workspace.ai/",
33+
"downloadUrl": "https://github.com/web3dev1337/agent-workspace/releases/latest",
34+
"description": "Agent Workspace is a local-first control plane for running multiple CLI coding agents across repositories and worktrees.",
35+
"isAccessibleForFree": true,
36+
"offers": {
37+
"@type": "Offer",
38+
"price": "0",
39+
"priceCurrency": "USD"
40+
},
41+
"publisher": {
42+
"@type": "Organization",
43+
"name": "Agent Workspace Maintainers",
44+
"url": "https://github.com/web3dev1337/agent-workspace"
45+
},
46+
"sameAs": [
47+
"https://github.com/web3dev1337/agent-workspace",
48+
"https://github.com/sponsors/web3dev1337"
49+
],
50+
"screenshot": "https://agent-workspace.ai/assets/home-page-windows.png"
51+
}
52+
</script>
53+
2354
<link rel="icon" href="assets/favicon.svg" type="image/svg+xml">
2455
<link rel="preconnect" href="https://fonts.googleapis.com">
2556
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
@@ -107,6 +138,12 @@ <h1 class="mega-title">
107138
<div class="integration-content reveal">
108139
<h2 class="section-title">A GUI for your TUIs.</h2>
109140
<p class="section-desc">Bring your CLIs. <span class="text-cyan">Agent Workspace</span> wraps your preferred terminal tools &mdash; run them side by side in the same workspace with your existing local auth and provider accounts.</p>
141+
<p class="section-desc"><strong>Compatibility rule:</strong> if a tool can be launched from a terminal command in your worktree, it can run in Agent Workspace.</p>
142+
<ul class="cli-compat-list">
143+
<li>Common examples: Claude Code, Codex CLI, Gemini CLI, OpenCode, Grok CLI.</li>
144+
<li>Also works with command-driven CLIs and scripts (for example Aider, Goose, or custom repo scripts).</li>
145+
<li>If a tool starts with a command, Agent Workspace can host it in a terminal pane.</li>
146+
</ul>
110147

111148
<div class="cli-grid">
112149
<div class="cli-card">
@@ -254,6 +291,16 @@ <h3 class="feature-title text-cyan">Runs Locally, Models by Provider</h3>
254291
</div>
255292
</article>
256293

294+
<article class="feature-card reveal" style="--delay: 0.03s">
295+
<div class="feature-copy">
296+
<h3 class="feature-title">Quick Answers</h3>
297+
<p class="feature-desc"><strong>Does Agent Workspace run locally?</strong> Yes. Sessions, workspaces, worktrees, and orchestration run on your machine.</p>
298+
<p class="feature-desc"><strong>Where does model inference run?</strong> Through the AI provider CLIs and accounts you configure.</p>
299+
<p class="feature-desc"><strong>Can it manage multiple repositories and worktrees?</strong> Yes. You can run one or many repositories with multiple worktrees in the same workspace.</p>
300+
<p class="feature-desc"><strong>Can I jump straight to GitHub diffs and PRs?</strong> Yes. The review workflow supports direct links to GitHub diffs and PR pages.</p>
301+
</div>
302+
</article>
303+
257304
<article class="feature-card reveal" style="--delay: 0.05s">
258305
<div class="feature-copy">
259306
<h3 class="feature-title text-blue-deep">Native Terminal Grid + Worktree Sidebar</h3>
@@ -369,13 +416,13 @@ <h3 class="feature-title">Multi-Tab Workspaces</h3>
369416
<p class="feature-desc">Open multiple workspaces at once in browser-like tabs. Switch contexts without killing sessions, and keep each workspace state isolated while terminals continue running in the background.</p>
370417
</div>
371418
<div class="feature-visual tabs-visual" aria-hidden="true">
372-
<img class="tab-strip-inline" src="assets/workspace-tabs-windows.png" alt="">
419+
<img class="tab-strip-inline" src="assets/workspace-tabs-windows.png" alt="Browser-like tabs showing two active workspaces in Agent Workspace">
373420
<div class="tabs-side-by-side">
374421
<figure class="tabs-shot">
375-
<img src="assets/home-page-windows.png" alt="">
422+
<img src="assets/home-page-windows.png" alt="Workspace 1 with multiple agent terminals and worktree sidebar">
376423
</figure>
377424
<figure class="tabs-shot">
378-
<img src="assets/workspace2-windows.png" alt="">
425+
<img src="assets/workspace2-windows.png" alt="Workspace 2 running a separate set of worktrees and agent sessions">
379426
</figure>
380427
</div>
381428
</div>

‎site/llms-full.txt‎

Lines changed: 58 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,58 @@
1+
# Agent Workspace
2+
3+
Agent Workspace is an open-source, local-first orchestration layer for CLI coding agents.
4+
5+
## Product Summary
6+
7+
- **What it is:** A GUI control plane for agent CLIs and server terminals.
8+
- **Who it is for:** Developers running parallel coding tasks, reviews, and runtime checks across worktrees.
9+
- **Core model:** Keep execution and orchestration local; use your own provider/CLI accounts for inference.
10+
11+
## Core Capabilities
12+
13+
1. **Workspaces + Worktrees**
14+
- One workspace can contain one or many repositories.
15+
- Each repository can run multiple worktrees in parallel.
16+
2. **Native Terminal Grid**
17+
- Agent sessions run in real terminals.
18+
- Side-by-side server panes can run websites, game runtimes, tests, and CLI commands.
19+
3. **Review and Diff Workflow**
20+
- Built-in review context with links to GitHub pull requests and diffs.
21+
- Re-prompt and verification loops from the same interface.
22+
4. **Task and Tier Flow**
23+
- Tier assignment (T1-T4) helps route focus, backup, batch review, and overnight runs.
24+
- Task board and project board views support ongoing planning and execution.
25+
5. **Ports and Runtime Visibility**
26+
- Track active services and assigned local ports.
27+
28+
## Quick Answers
29+
30+
- **Does Agent Workspace run locally?**
31+
Yes. Sessions, workspaces, and orchestration run locally.
32+
- **Where do model requests run?**
33+
Through the provider CLIs and accounts selected by the user.
34+
- **Can it run more than one repository at once?**
35+
Yes, via mixed-repository workspace configuration.
36+
- **Can users jump directly to GitHub PRs and diffs?**
37+
Yes, the review flow includes direct GitHub link actions.
38+
39+
## Installation
40+
41+
### Windows (recommended)
42+
- Download: <https://github.com/web3dev1337/agent-workspace/releases/latest>
43+
44+
### Source
45+
```bash
46+
git clone https://github.com/web3dev1337/agent-workspace.git
47+
cd agent-workspace && npm install
48+
npm start
49+
```
50+
51+
## Canonical Links
52+
53+
- Homepage: <https://agent-workspace.ai/>
54+
- Repository: <https://github.com/web3dev1337/agent-workspace>
55+
- README: <https://github.com/web3dev1337/agent-workspace#readme>
56+
- Terms: <https://agent-workspace.ai/terms.html>
57+
- Privacy: <https://agent-workspace.ai/privacy.html>
58+
- Sponsors: <https://github.com/sponsors/web3dev1337>

‎site/llms.txt‎

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
# Agent Workspace
2+
> Local-first control plane for running multiple CLI coding agents across repositories and worktrees.
3+
4+
Agent Workspace helps teams run agent sessions, server processes, reviews, and task flow in one interface while keeping orchestration on local hardware.
5+
6+
## Key Facts
7+
- Runs locally: sessions, workspaces, and orchestration run on your machine.
8+
- Models by provider: inference runs through the provider CLIs and accounts you configure.
9+
- Multi-repo and multi-worktree: one workspace can include one or many repositories with parallel worktrees.
10+
- Review workflow: in-app review with direct links to GitHub pull requests and diffs.
11+
12+
## Primary Pages
13+
- [Homepage](https://agent-workspace.ai/)
14+
- [GitHub Repository](https://github.com/web3dev1337/agent-workspace)
15+
- [README](https://github.com/web3dev1337/agent-workspace#readme)
16+
- [Latest Release](https://github.com/web3dev1337/agent-workspace/releases/latest)
17+
- [Security Policy](https://github.com/web3dev1337/agent-workspace/blob/main/SECURITY.md)
18+
- [Terms of Use](https://agent-workspace.ai/terms.html)
19+
- [Privacy Policy](https://agent-workspace.ai/privacy.html)
20+
21+
## Sponsor
22+
- [GitHub Sponsors](https://github.com/sponsors/web3dev1337)

‎site/robots.txt‎

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
User-agent: OAI-SearchBot
2+
Allow: /
3+
4+
User-agent: GPTBot
5+
Allow: /
6+
7+
User-agent: Google-Extended
8+
Allow: /
9+
10+
User-agent: ClaudeBot
11+
Allow: /
12+
13+
User-agent: Claude-User
14+
Allow: /
15+
16+
User-agent: Claude-SearchBot
17+
Allow: /
18+
19+
User-agent: PerplexityBot
20+
Allow: /
21+
22+
User-agent: Perplexity-User
23+
Allow: /
24+
25+
User-agent: *
26+
Allow: /
27+
28+
Sitemap: https://agent-workspace.ai/sitemap.xml

‎site/sitemap.xml‎

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
<?xml version="1.0" encoding="UTF-8"?>
2+
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
3+
<url>
4+
<loc>https://agent-workspace.ai/</loc>
5+
</url>
6+
<url>
7+
<loc>https://agent-workspace.ai/terms.html</loc>
8+
</url>
9+
<url>
10+
<loc>https://agent-workspace.ai/privacy.html</loc>
11+
</url>
12+
<url>
13+
<loc>https://agent-workspace.ai/llms.txt</loc>
14+
</url>
15+
<url>
16+
<loc>https://agent-workspace.ai/llms-full.txt</loc>
17+
</url>
18+
</urlset>

‎site/styles.css‎

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1042,6 +1042,28 @@ a.btn-glow {
10421042
margin: 0 auto 2.5rem;
10431043
}
10441044

1045+
.cli-compat-list {
1046+
max-width: 860px;
1047+
margin: -1.25rem auto 2.5rem;
1048+
padding: 1rem 1.25rem;
1049+
list-style: none;
1050+
text-align: left;
1051+
background: rgba(7, 15, 33, 0.55);
1052+
border: 1px solid rgba(255, 255, 255, 0.1);
1053+
border-radius: 12px;
1054+
}
1055+
1056+
.cli-compat-list li {
1057+
color: var(--text-muted);
1058+
margin: 0.4rem 0;
1059+
line-height: 1.5;
1060+
}
1061+
1062+
.cli-compat-list li::before {
1063+
content: "• ";
1064+
color: var(--cyan);
1065+
}
1066+
10451067
.logo-showcase {
10461068
display: flex;
10471069
align-items: center;

0 commit comments

Comments
 (0)