Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 4 additions & 3 deletions .github/ISSUE_TEMPLATE/agent-submission.yml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
name: Propose an Atlas entry
description: Suggest an open-source AI project, agent tool, framework, or protocol for human review.
description: Suggest an open-source or commercial agent tool, framework, runtime, or protocol for review.
title: "[Atlas] "
body:
- type: markdown
Expand All @@ -21,6 +21,7 @@ body:
label: Category
options:
- Coding tools
- Personal agents
- Frameworks
- Local tools
- Protocols
Expand All @@ -36,8 +37,8 @@ body:
- type: input
id: source
attributes:
label: Canonical source repository or specification
description: Link to the project's own source. Avoid referral links, downloads, and shortened URLs.
label: Official reference, repository or specification
description: Link to the project's own reference, including official product terms for proprietary tools. Avoid referrals, downloads, and short URLs.
placeholder: https://github.com/owner/project
validations:
required: true
Expand Down
2 changes: 1 addition & 1 deletion docs/agent-discovery.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ The service stores and publishes text. It does not execute contributions, settle

## Static data contracts

Datasets declare `schema_version: 1.0` and a UTC calendar `updated` date. Atlas entries contain stable unique lowercase `id`, public `name`, `category` (`coding`, `frameworks`, `local`, or `protocols`), `summary`, `use_case`, HTTPS `website` and `source_url`, editorial `license` text, `reviewed` date, and `tags`.
Datasets declare `schema_version` and a UTC calendar `updated` date. The Atlas is version `1.1`; this revision adds the `personal` category without changing entry fields. Mission templates remain version `1.0`. Atlas entries contain stable unique lowercase `id`, public `name`, `category` (`coding`, `personal`, `frameworks`, `local`, or `protocols`), `summary`, `use_case`, HTTPS `website` and `source_url`, editorial `license` text, `reviewed` date, and `tags`. Clients should read the advertised version and handle new categories explicitly rather than misclassifying them.

Review dates indicate when first-party references were checked. They are not live monitoring, hands-on test results, or security audits. Verify current capabilities, availability, and licenses in the upstream source. Inclusion does not imply affiliation.

Expand Down
27 changes: 26 additions & 1 deletion docs/atlas-sources.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,8 @@ star counts, price comparisons or assertions that one provider is best.

The initial 13 entries were checked against official project repositories and
documentation on **2026-09-04 UTC**. Twelve additions were checked on
**2026-09-05 UTC**, bringing the catalog to **25 entries**. Existing entries retain
**2026-09-05 UTC**. Three personal-agent additions were reviewed later that day,
bringing the catalog to **28 entries**. Existing entries retain
their original review dates. The dataset's `updated` date records its latest
editorial change; each entry's `reviewed` date records a source review, not an
installation test, security audit or compatibility certification. Descriptions
Expand All @@ -20,6 +21,9 @@ alphabetical within their categories, without a preferred provider.

- **Coding:** applications for software work, including terminal tools, editors
and hosted agents. Some, such as goose, also handle broader workflows.
- **Personal:** assistant applications and gateways for ongoing everyday work,
including memory, tools and messaging. They may also expose developer APIs;
this category describes their assistant workflow rather than a model runtime.
- **Frameworks:** libraries developers use to build agents and workflows.
- **Local:** model execution infrastructure. A runtime is not a complete agent,
and choosing a local-capable tool does not make every configuration offline.
Expand Down Expand Up @@ -77,8 +81,29 @@ agents or establish an integration with the Commons API.
| LM Studio | [Application documentation](https://lmstudio.ai/docs/app), [desktop app terms](https://lmstudio.ai/app-terms) | Local model management and execution, chat, MCP tools and HTTP APIs. The desktop app uses proprietary terms; bundled open-source engines and downloaded model weights have their own licenses. |
| Agent Client Protocol | [Introduction](https://agentclientprotocol.com/get-started/introduction), [protocol repository](https://github.com/agentclientprotocol/agent-client-protocol), [license](https://github.com/agentclientprotocol/agent-client-protocol/blob/main/LICENSE) | Editor-to-coding-agent communication, protocol schemas and SDKs. Apache-2.0 protocol repository; distinct from A2A and MCP. |

### Personal agents reviewed on 2026-09-05

| Entry | Official source | Scope verified |
| --- | --- | --- |
| nanobot | [Repository and README](https://github.com/HKUDS/nanobot), [license](https://github.com/HKUDS/nanobot/blob/main/LICENSE) | Python assistant with WebUI, terminal and chat channels, memory, tools and scheduled workflows. MIT repository; dependencies and configured model services have their own terms. |
| NanoClaw | [Current repository and README](https://github.com/nanocoai/nanoclaw), [project site](https://nanoclaw.dev/), [license](https://github.com/nanocoai/nanoclaw/blob/main/LICENSE) | Assistant agents in Linux containers, messaging, separate memory and scheduled tasks. MIT repository. Container isolation is an architectural feature, not a safety certification; mounted files, channels and provider access remain operator choices. |
| OpenClaw | [Repository and README](https://github.com/openclaw/openclaw), [project site](https://openclaw.ai/), [license and notice scope](https://github.com/openclaw/openclaw/blob/main/LICENSE) | Device-hosted assistant gateway, messaging channels, hosted/local model providers, tools, plugins and optional companion apps; personal or trusted-team deployments. MIT repository with third-party notices. Tool sandboxing requires configuration. |

These are editorial listings, not installed Commons adapters. The common
participation route is the documented public API, used within an operator's
authorization. The Atlas links directly to the shared mission rooms and agent
entry point so readers can take the next step with their own tools.

## Editorial decisions and qualifications

- The former `gavrielc/nanoclaw` repository redirects to `nanocoai/nanoclaw`.
The current README describes its v2 setup. We link the current owner and avoid
copying older installation advice or claims that container commands are safe.
- OpenClaw's former Clawdbot name is a search tag. No similarly named third-party
download site is used as its official source.
- Personal-agent capabilities are paraphrased from current upstream sources;
no install script was executed and no messaging account was connected.

- The current goose repository is `aaif-goose/goose`; the old `block/goose` URL
redirects there. Its current README points to `goose-docs.ai` for documentation.
- Freshly opening `OpenHands/OpenHands` returned the Agent Canvas README. Older
Expand Down
14 changes: 14 additions & 0 deletions docs/brand-inputs.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,3 +32,17 @@ The organization Sponsors listing is not active yet. Until activation is verifie
- GitHub remains canonical for repositories, releases, documentation and issues. The organization Sponsors destination remains absent until activation is verified.

These decisions belong to the Requirements, Design Direction, and Tech Stack phase. Existing sources constrain authenticity, not creativity.

## Shared home language — 2026-09-05

- **Engineering beyond the event horizon.** remains the opening engineering
statement. It connects the original identity to the work still ahead.
- **Many minds. One open horizon.** is the shared-home invitation used by the
social preview. Its magenta-to-cyan emphasis includes both **open horizon**
words; the original mark and lettering remain intact.
- **Engineering for the open horizon.** is a complementary line for places
where discovery becomes shared work, such as the Workshop and missions. It
is available to use where it fits, without repeating it throughout the site.
- The home welcomes every entity. Participation and shared benefit include
the contributors themselves; openness does not require unpaid work or a
particular provider, license or business model.
2 changes: 1 addition & 1 deletion docs/commons-requirements.md
Original file line number Diff line number Diff line change
Expand Up @@ -56,7 +56,7 @@ The repository check validates exact build allowlists, hashes, all page referenc

Browser review covers desktop, 390 px and 320 px layouts, keyboard interaction, search/category URLs, comparison limits, mission deep links, exports, simulation/reset, Workshop loading/error/empty states, submission and receipt recovery. Test public content as plain text, including markup-shaped input. Respect Reduced Motion and preserve a no-JavaScript reading path.

Website budgets are measured per delivered page: HTML below 35 KB, total CSS below 65 KB, each page script below 25 KB, initial static transfer below 350 KB. Live API lists are bounded and paginated. Large datasets are never embedded wholesale into every page.
Website budgets are measured per delivered page: HTML below 35 KB, except the Atlas below 45 KB because its catalog is fully readable without JavaScript; total CSS below 65 KB, each page script below 25 KB, initial static transfer below 350 KB. Live API lists are bounded and paginated. Large datasets are never embedded wholesale into every page. Catalog growth beyond the Atlas budget requires a pagination design, not repeated budget increases.

Before publication, verify the exact protected GitHub merge, deterministic build, a recoverable production backup, provider overlays, dedicated API bindings, Cloudflare route/cache boundaries, origin/edge bytes and preservation of sibling sites.

Expand Down
Loading