Skip to content

Agent Mesh

site,docs: serve website from google.github.io/agentmesh

Antonio Ojea11ff26e7af41
diff --git a/.github/workflows/deploy-github-pages.yml b/.github/workflows/deploy-github-pages.yml
index a22fb89a..2ba9f42d 100644
--- a/.github/workflows/deploy-github-pages.yml
+++ b/.github/workflows/deploy-github-pages.yml
@@ -48,12 +48,9 @@ jobs:
working-directory: ./site
- name: Build Hugo Site
- run: hugo --baseURL https://sam-mesh.dev --minify
+ run: hugo --baseURL https://google.github.io/agentmesh/ --minify
working-directory: ./site
- - name: Create CNAME
- run: echo "sam-mesh.dev" > ./site/public/CNAME
-
- name: Upload artifact
uses: actions/upload-pages-artifact@fc324d3547104276b827a68afc52ff2a11cc49c9 # v5.0.0
with:
diff --git a/README.md b/README.md
index d3e68d09..8fb604fa 100644
--- a/README.md
+++ b/README.md
@@ -26,18 +26,18 @@ Two properties hold everywhere:
## Try it
```bash
-curl -sL https://raw.githubusercontent.com/google/agentmesh/main/install.sh | bash # agentmesh-one, agentmesh-node, mcp-client and friends
-agentmesh-one --data-dir ~/agentmesh-one --port 8080 & # start a local control plane, router and web console
-agentmesh-node join http://127.0.0.1:8080 --bootstrap-token-path ~/agentmesh-one/join-token
-agentmesh-node run --daemonize # local MCP server on 127.0.0.1:8080
-agentmesh-node skill install # teach your agent to use it
+curl -sL https://google.github.io/agentmesh/install.sh | bash # agentmesh-node, mcp-client and friends
+agentmesh-node join https://bananas.sam-mesh.dev # one-time login
+agentmesh-node run --daemonize # local MCP server on 127.0.0.1:8080
+agentmesh-node skill install # teach your agent to use it
```
Your agent now has tools that discover and call services across the mesh,
and an OpenAI-compatible endpoint that routes model requests to whoever
-serves the model. The [quick start](site/content/docs/getting-started/quickstart.md)
-and [your own mesh](site/content/docs/getting-started/your-own-mesh.md) guides
-walk through joining an existing mesh or running a control plane of your own.
+serves the model. `bananas.sam-mesh.dev` is a shared developer testnet with
+no uptime promise; the [quick start](https://google.github.io/agentmesh/docs/getting-started/quickstart/)
+walks through it, and [your own mesh](https://google.github.io/agentmesh/docs/getting-started/your-own-mesh/)
+runs a control plane on your laptop in one command.
To run a control plane of your own without installing anything, open a
GitHub codespace with the released binaries and run `make testnet`. It
@@ -46,7 +46,7 @@ on your GitHub account's free quota:
[![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/google/agentmesh?quickstart=1&devcontainer_path=.devcontainer%2Ftestnet%2Fdevcontainer.json)
-The [Codespaces guide](site/content/docs/guides/codespaces.md) has the
+The [Codespaces guide](https://google.github.io/agentmesh/docs/guides/codespaces/) has the
steps, what persists and what stops.
## What is in a mesh
@@ -60,14 +60,14 @@ steps, what persists and what stops.
## Documentation
-Documentation is in [`site/content/docs/`](site/content/docs/):
+[google.github.io/agentmesh/docs](https://google.github.io/agentmesh/docs/) is built from `site/`.
-- [Getting started](site/content/docs/getting-started/_index.md): one node on a mesh, then a mesh of your own.
-- [Concepts](site/content/docs/concepts/_index.md): architecture, identity and enrollment, authorization, networking.
-- [Guides](site/content/docs/guides/_index.md): exposing services, connecting agent clients, headless enrollment, Kubernetes, Cloud Run.
-- [Reference](site/content/docs/reference/_index.md): every flag, configuration key, HTTP route and policy field.
-- [Preview](site/content/docs/preview/_index.md): sandboxed agents and the mobile app, which work but are still settling.
-- [Contributing](site/content/docs/contributing/_index.md): building, testing and the local kind environment.
+- [Getting started](https://google.github.io/agentmesh/docs/getting-started/): one node on the testnet, then a mesh of your own.
+- [Concepts](https://google.github.io/agentmesh/docs/concepts/): architecture, identity and enrollment, authorization, networking.
+- [Guides](https://google.github.io/agentmesh/docs/guides/): exposing services, connecting agent clients, headless enrollment, Kubernetes, Cloud Run.
+- [Reference](https://google.github.io/agentmesh/docs/reference/): every flag, configuration key, HTTP route and policy field.
+- [Preview](https://google.github.io/agentmesh/docs/preview/): sandboxed agents and the mobile app, which work but are still settling.
+- [Contributing](https://google.github.io/agentmesh/docs/contributing/): building, testing and the local kind environment.
The repository has a dev container with the Go, Node and Python toolchains
and Docker, so you can build and test in a codespace or in VS Code without
diff --git a/agents/skills/agentmesh/SKILL.md b/agents/skills/agentmesh/SKILL.md
index dd7d8fe5..0f0fa033 100644
--- a/agents/skills/agentmesh/SKILL.md
+++ b/agents/skills/agentmesh/SKILL.md
@@ -30,7 +30,7 @@ guide the user through these steps. Propose each shell command and let the user
approve it before running anything.
1. Check the CLI: `agentmesh-node --help`. If it is missing, install it with
- `curl -sL https://raw.githubusercontent.com/google/agentmesh/main/install.sh | bash` or
+ `curl -sL https://google.github.io/agentmesh/install.sh | bash` or
`go install github.com/google/agentmesh/cmd/agentmesh-node@latest`.
2. Start the node in the background: `agentmesh-node run --daemonize`. It returns as
soon as the node answers, and prints the endpoint, the API token file, the
diff --git a/api/trust_test.go b/api/trust_test.go
index 1c363b60..c07b78cb 100644
--- a/api/trust_test.go
+++ b/api/trust_test.go
@@ -29,7 +29,7 @@ func TestValidateControlPlaneTransport(t *testing.T) {
wantErr bool
wantKind error
}{
- {"https://hub.agentmesh.page", false, false, nil},
+ {"https://hub.sam-mesh.dev", false, false, nil},
{"https://10.0.0.5:8443", false, false, nil},
{"http://127.0.0.1:8080", false, false, nil},
{"http://localhost:8080", false, false, nil},
@@ -49,8 +49,8 @@ func TestValidateControlPlaneTransport(t *testing.T) {
{"https://", false, true, nil},
{"https://:8443", false, true, nil},
{"http://", true, true, nil},
- {"ftp://hub.agentmesh.page", false, true, nil},
- {"hub.agentmesh.page", false, true, nil},
+ {"ftp://hub.sam-mesh.dev", false, true, nil},
+ {"hub.sam-mesh.dev", false, true, nil},
}
for _, tt := range tests {
t.Run(tt.url, func(t *testing.T) {
diff --git a/charts/agentmesh/README.md b/charts/agentmesh/README.md
index 304a7444..67a6011c 100644
--- a/charts/agentmesh/README.md
+++ b/charts/agentmesh/README.md
@@ -6,7 +6,7 @@ own mesh.
> For deployments on GKE/EKS/AKS with externally managed Postgres, DNS and
> OIDC, see the
-> [Kubernetes guide](../../site/content/docs/guides/kubernetes.md).
+> [Kubernetes guide](https://google.github.io/agentmesh/docs/guides/kubernetes/).
## Install
@@ -64,7 +64,7 @@ Defaults to `true` (any node/router presenting a valid identity token is
enrolled immediately, no manual step). Set to `false` if you want an
administrator to approve each enrollment via `/admin/enrollments` before a
node can join — see the
-[Headless enrollment guide](../../site/content/docs/guides/headless-enrollment.md).
+[Headless enrollment guide](https://google.github.io/agentmesh/docs/guides/headless-enrollment/).
## `controlPlane.workloadIssuer` and `controlPlane.workloadSessionTtl`
diff --git a/cmd/agentmesh-node/main_test.go b/cmd/agentmesh-node/main_test.go
index 2d43d4ce..5a4024de 100644
--- a/cmd/agentmesh-node/main_test.go
+++ b/cmd/agentmesh-node/main_test.go
@@ -64,9 +64,9 @@ func TestResolveSocketPath(t *testing.T) {
func TestNormalizeControlPlaneURL(t *testing.T) {
cases := map[string]string{
- "bananas.agentmesh.page": "https://bananas.agentmesh.page",
- "http://localhost:8080": "http://localhost:8080",
- "https://bananas.agentmesh.page/": "https://bananas.agentmesh.page",
+ "bananas.sam-mesh.dev": "https://bananas.sam-mesh.dev",
+ "http://localhost:8080": "http://localhost:8080",
+ "https://bananas.sam-mesh.dev/": "https://bananas.sam-mesh.dev",
}
for in, want := range cases {
if got := normalizeControlPlaneURL(in); got != want {
diff --git a/cmd/agentmesh-node/skill.go b/cmd/agentmesh-node/skill.go
index 9da62101..25c4e797 100644
--- a/cmd/agentmesh-node/skill.go
+++ b/cmd/agentmesh-node/skill.go
@@ -179,7 +179,7 @@ Next steps:
--header "X-Mesh-Authentication: Bearer <token>"
Antigravity add that URL as "serverUrl", with the same header, to
~/.gemini/config/mcp_config.json
- Other agents: https://github.com/google/agentmesh/blob/main/site/content/docs/guides/connecting-agents.md
+ Other agents: https://google.github.io/agentmesh/docs/guides/connecting-agents/
3. Restart your agent so it picks up the skill and the mesh tools.
`)
}
diff --git a/development/examples/multi-tier-guardrails/record.sh b/development/examples/multi-tier-guardrails/record.sh
index 955c548c..9a3ccd09 100755
--- a/development/examples/multi-tier-guardrails/record.sh
+++ b/development/examples/multi-tier-guardrails/record.sh
@@ -394,7 +394,7 @@ caption "Act 4 (Day-2 Operations): Every ALLOW and DENY across all three layers
expect "$ADMIN" "agentmesh-one admin ban \$CONTRACTOR_PEER --server \$CP_URL --data-dir \$WORK_DIR/one" 'banned' 30
pause 3.5
-caption "github.com/google/agentmesh"
+caption "google.github.io/agentmesh"
pause 3
END=$(date +%s.%N)
diff --git a/development/examples/sandboxed-agent/record.sh b/development/examples/sandboxed-agent/record.sh
index 572d85b6..d15e159c 100755
--- a/development/examples/sandboxed-agent/record.sh
+++ b/development/examples/sandboxed-agent/record.sh
@@ -285,7 +285,7 @@ pause 2
# 8. Close
caption "The developer used their own sandbox and wrote a plain program. The admin wrote one policy document and read one log. The credential never left the office."
pause 1
-caption "github.com/google/agentmesh"
+caption "google.github.io/agentmesh"
pause 3
# Ends the recording: the attached client exits with the session.
diff --git a/scripts/startup-script.sh b/scripts/startup-script.sh
index f03e7612..6595008e 100644
--- a/scripts/startup-script.sh
+++ b/scripts/startup-script.sh
@@ -55,7 +55,7 @@ if [ -n "$BIN_URL" ] && [ "$BIN_URL" != "null" ]; then
else
echo "No custom binaries specified. Installing latest release from github..."
export AGENTMESH_INSTALL_DIR=/usr/local/bin
- curl --retry 5 --retry-connrefused --retry-delay 5 -sL https://raw.githubusercontent.com/google/agentmesh/main/install.sh | bash
+ curl --retry 5 --retry-connrefused --retry-delay 5 -sL https://google.github.io/agentmesh/install.sh | bash
fi
# Download the uncompressed Linux kernel for Firecracker.
diff --git a/sdk/js/README.md b/sdk/js/README.md
index 1191cde9..29e63465 100644
--- a/sdk/js/README.md
+++ b/sdk/js/README.md
@@ -9,7 +9,7 @@ and follows the control plane's keys, bans and policy while it runs. It
publishes no service; a tool or a model others should find by name runs
behind a `agentmesh-node`.
-Guide: [Native SDKs](https://github.com/google/agentmesh/blob/main/site/content/docs/guides/native-sdks.md),
+Guide: [google.github.io/agentmesh/docs/guides/native-sdks](https://google.github.io/agentmesh/docs/guides/native-sdks/),
from an empty machine to two programs on a mesh.
Source: [github.com/google/agentmesh/tree/main/sdk/js](https://github.com/google/agentmesh/tree/main/sdk/js).
@@ -21,7 +21,7 @@ npm install agentmesh-p2p @modelcontextprotocol/sdk zod
Requires Node.js 22.18 or later. In a browser, bundle it with the page
(the package's `browser` field selects the browser files); the guide's
-[In a browser](https://github.com/google/agentmesh/blob/main/site/content/docs/guides/native-sdks.md#in-a-browser)
+[In a browser](https://google.github.io/agentmesh/docs/guides/native-sdks/#in-a-browser)
section has the details and an example page.
## Use
diff --git a/sdk/python/README.md b/sdk/python/README.md
index 5847f4c3..0dd21daf 100644
--- a/sdk/python/README.md
+++ b/sdk/python/README.md
@@ -9,7 +9,7 @@ publishes no service; a tool or a model others should find by name runs
behind a `agentmesh-node`. Import it as
`agent_mesh`.
-Guide: [Native SDKs](https://github.com/google/agentmesh/blob/main/site/content/docs/guides/native-sdks.md),
+Guide: [google.github.io/agentmesh/docs/guides/native-sdks](https://google.github.io/agentmesh/docs/guides/native-sdks/),
from an empty machine to two programs on a mesh.
Source: [github.com/google/agentmesh/tree/main/sdk/python](https://github.com/google/agentmesh/tree/main/sdk/python).
diff --git a/site/content/docs/contributing/_index.md b/site/content/docs/contributing/_index.md
index d0326b75..1ae807be 100644
--- a/site/content/docs/contributing/_index.md
+++ b/site/content/docs/contributing/_index.md
@@ -136,7 +136,7 @@ The site is Hugo with the Docsy theme, under `site/`. The deploy workflow
pins Hugo 0.136.5, and newer Hugo releases do not build the current Docsy
version, so use that release locally too. Run `npm ci` once in `site/` for
the CSS pipeline, then `hugo server`. The site deploys from `main` to
-`sam-mesh.dev`. When a page moves, keep its old URL with `aliases` in the
+`google.github.io/agentmesh`. When a page moves, keep its old URL with `aliases` in the
front matter. `tests/e2e/docs_snippets.bats` runs the Python snippet under
`site/content/docs/snippets/` against a live node, so a change to that
snippet is a change to a test.
diff --git a/site/content/docs/getting-started/quickstart.md b/site/content/docs/getting-started/quickstart.md
index 848b6249..aca26777 100644
--- a/site/content/docs/getting-started/quickstart.md
+++ b/site/content/docs/getting-started/quickstart.md
@@ -19,7 +19,7 @@ On Linux and macOS, the install script downloads the latest release and
places the binaries in `/usr/local/bin`:
```bash
-curl -sL https://raw.githubusercontent.com/google/agentmesh/main/install.sh | bash
+curl -sL https://google.github.io/agentmesh/install.sh | bash
```
With a Go toolchain, you can build from source instead:
diff --git a/site/content/docs/preview/mobile.md b/site/content/docs/preview/mobile.md
index 57dd42f0..a2eec96b 100644
--- a/site/content/docs/preview/mobile.md
+++ b/site/content/docs/preview/mobile.md
@@ -54,7 +54,7 @@ update because its signature differs from the installed app, report it to
the coordinator. Uninstalling or clearing app storage deletes the saved
identity and settings.
-{{< figure src="/images/agentmesh-connect-welcome.png" alt="Agent Mesh Connect welcome screen with Scan enrollment code and Enter details manually buttons" caption="The welcome screen offers both paths: Enter details manually for a public testnet, or Scan enrollment code for your own mesh." width="320" >}}
+{{< figure src="../../../images/agentmesh-connect-welcome.png" alt="Agent Mesh Connect welcome screen with Scan enrollment code and Enter details manually buttons" caption="The welcome screen offers both paths: Enter details manually for a public testnet, or Scan enrollment code for your own mesh." width="320" >}}
### 2. Choose your mesh
@@ -100,7 +100,7 @@ Then follow option A or option B.
Connect using the app switcher. Keep the app open while enrollment
finishes. The browser message only confirms the login callback.
-{{< figure src="/images/agentmesh-connect-public-login.png" alt="Cropped manual enrollment form with the Bananas control plane URL, an empty Enrollment token field, and Login and Enroll Browser button" caption="Public-testnet enrollment (cropped view). Enter your chosen testnet URL, leave Enrollment token empty, and use Login & Enroll (Browser)." width="420" >}}
+{{< figure src="../../../images/agentmesh-connect-public-login.png" alt="Cropped manual enrollment form with the Bananas control plane URL, an empty Enrollment token field, and Login and Enroll Browser button" caption="Public-testnet enrollment (cropped view). Enter your chosen testnet URL, leave Enrollment token empty, and use Login & Enroll (Browser)." width="420" >}}
If you need to sign in on another device, choose **Device Login (TV / Other
Device)** instead. Open the displayed verification URL on that device,
@@ -200,7 +200,7 @@ mesh://enroll?server=https%3A%2F%2Fused-encryption-assumptions-miller.trycloudfl
Token ID: 2542ac5fa60e (revoke early with: agentmesh-one token revoke 2542ac5fa60e)
```
-{{< figure src="/images/agentmesh-connect-join.png" alt="Join this mesh confirmation dialog showing a control plane hostname and Cancel and Join buttons" caption="After scanning, check the control plane hostname before tapping Join. This screenshot shows an example tunnel address and the app's shortened token hint; your values will differ." width="320" >}}
+{{< figure src="../../../images/agentmesh-connect-join.png" alt="Join this mesh confirmation dialog showing a control plane hostname and Cancel and Join buttons" caption="After scanning, check the control plane hostname before tapping Join. This screenshot shows an example tunnel address and the app's shortened token hint; your values will differ." width="320" >}}
The phone must be able to reach the HTTPS address. A computer's
`http://127.0.0.1` address refers to the phone itself when used on the phone,
@@ -247,7 +247,7 @@ or shows an error, record the status text before retrying.
**Node is Running** alone does not prove a mesh connection. Report a peer
count that remains zero, even if the app shows no error.
-{{< figure src="/images/agentmesh-connect-running.png" alt="Agent Mesh Connect dashboard showing Node is Running, one connected peer, DHT size one, and a Node ID" caption="A connected node shows Node is Running, a Node ID, and at least one Connected Peer. Your Node ID and peer counts will differ from this example." width="320" >}}
+{{< figure src="../../../images/agentmesh-connect-running.png" alt="Agent Mesh Connect dashboard showing Node is Running, one connected peer, DHT size one, and a Node ID" caption="A connected node shows Node is Running, a Node ID, and at least one Connected Peer. Your Node ID and peer counts will differ from this example." width="320" >}}
### 5. Check restart and reconnection
diff --git a/site/content/docs/privacy.md b/site/content/docs/privacy.md
index 861264cf..978bc5c6 100644
--- a/site/content/docs/privacy.md
+++ b/site/content/docs/privacy.md
@@ -42,4 +42,5 @@ You can instantly erase all app data, destroy your local node identity, and revo
If you have any questions about this Privacy Policy, architecture, or how your data is handled, please contact us at:
+* **Project Website:** [https://google.github.io/agentmesh/](https://google.github.io/agentmesh/)
* **GitHub Repository:** [https://github.com/google/agentmesh](https://github.com/google/agentmesh)
diff --git a/site/content/docs/use-cases/multi-tier-guardrails.md b/site/content/docs/use-cases/multi-tier-guardrails.md
index 9b963b97..0f17ed59 100644
--- a/site/content/docs/use-cases/multi-tier-guardrails.md
+++ b/site/content/docs/use-cases/multi-tier-guardrails.md
@@ -4,8 +4,8 @@ weight: 25
description: "How Developer, Platform, Central Security, Department Leads, Individual End-Users, and Day-2 Ops each enforce their own layer of guardrails on the same mesh."
---
-<video controls playsinline preload="metadata" poster="/demo-poster.png" style="width:100%; border-radius:8px; box-shadow:0 4px 20px rgba(0,0,0,0.4); margin-bottom: 1.5rem;">
- <source src="/demo-multi-tier-guardrails.mp4" type="video/mp4">
+<video controls playsinline preload="metadata" poster="../../../demo-poster.png" style="width:100%; border-radius:8px; box-shadow:0 4px 20px rgba(0,0,0,0.4); margin-bottom: 1.5rem;">
+ <source src="../../../demo-multi-tier-guardrails.mp4" type="video/mp4">
</video>
When every developer and team starts shipping AI agents, organizations hit a governance paradox:
diff --git a/site/hugo.toml b/site/hugo.toml
index 1b68e65e..01f41c99 100644
--- a/site/hugo.toml
+++ b/site/hugo.toml
@@ -1,5 +1,5 @@
title = "Agent Mesh"
-baseURL = "https://sam-mesh.dev"
+baseURL = "https://google.github.io/agentmesh/"
languageCode = "en-us"
enableRobotsTXT = true
diff --git a/site/layouts/partials/hooks/head-end.html b/site/layouts/partials/hooks/head-end.html
index 7792a4ad..9bbf3f07 100644
--- a/site/layouts/partials/hooks/head-end.html
+++ b/site/layouts/partials/hooks/head-end.html
@@ -6,6 +6,6 @@
</script>
<!-- Agent Mesh Custom Favicons -->
-<link rel="icon" type="image/png" href="/favicon.png?v=2">
-<link rel="shortcut icon" href="/favicon.ico?v=2">
+<link rel="icon" type="image/png" href="{{ "favicon.png?v=2" | relURL }}">
+<link rel="shortcut icon" href="{{ "favicon.ico?v=2" | relURL }}">
<link rel="manifest" href="{{ "manifest.json" | relURL }}">
diff --git a/site/static/manifest.json b/site/static/manifest.json
index 2cceaa29..811d7c41 100644
--- a/site/static/manifest.json
+++ b/site/static/manifest.json
@@ -3,32 +3,32 @@
"short_name": "Agent Mesh",
"icons": [
{
- "src": "/favicons/android-36x36.png",
+ "src": "favicons/android-36x36.png",
"sizes": "36x36",
"type": "image/png"
},
{
- "src": "/favicons/android-48x48.png",
+ "src": "favicons/android-48x48.png",
"sizes": "48x48",
"type": "image/png"
},
{
- "src": "/favicons/android-72x72.png",
+ "src": "favicons/android-72x72.png",
"sizes": "72x72",
"type": "image/png"
},
{
- "src": "/favicons/android-96x96.png",
+ "src": "favicons/android-96x96.png",
"sizes": "96x96",
"type": "image/png"
},
{
- "src": "/favicons/android-144x144.png",
+ "src": "favicons/android-144x144.png",
"sizes": "144x144",
"type": "image/png"
},
{
- "src": "/favicons/android-192x192.png",
+ "src": "favicons/android-192x192.png",
"sizes": "192x192",
"type": "image/png"
}
@@ -36,5 +36,5 @@
"theme_color": "#040911",
"background_color": "#040911",
"display": "standalone",
- "start_url": "/"
+ "start_url": "."
}