awesome-agents 0.1.6 → 0.1.9

package/CHANGELOG.md

@@ -2,6 +2,58 @@
 
 This file is maintained by `npm run changelog` and `npm run release`. Release entries are generated from git commit history.
 
+## 0.1.9 - 2026-07-16
+
+Changes since `v0.1.8`.
+
+### Added
+
+- Add create-agent-profile skill (f5dcfe0)
+
+### Changed
+
+- Expose agent-owned support to installed profiles (#12) (832094e)
+- Name awesome-agents profiles directly (9640910)
+- Remove agents nav link (3ad6bb3)
+- Restore coral site accent (ba2ec5c)
+- Refresh site agent directory (2268134)
+- Make skill dependency resolution fault-tolerant instead of fatal (78aea64)
+
+## 0.1.8 - 2026-07-08
+
+Changes since `v0.1.6`.
+
+### Added
+
+- Add "What is an agent?" marketing page and link it site-wide (fa8255e)
+- Add Goose to site harness surfaces (7a444cf)
+- Add Goose harness support (#9) (c4049f2)
+- Add public builder profile prototype (e78202e)
+- Add plan for public-builder-profiles-agent-model-cards (64e254a)
+- Add generated docs site (8eb21ba)
+
+### Changed
+
+- Prepare 0.1.7 release (342e93d)
+- Link hosted artifacts for public-builder-profiles-agent-model-cards (0f76238)
+- Update tenex-edge launch commands (cc304e2)
+
+### Documentation
+
+- rebuild /docs in the shadcn-docs layout (878803c)
+
+## 0.1.7 - 2026-07-07
+
+Changes since `v0.1.6`.
+
+### Added
+
+- Add generated docs site (8eb21ba)
+
+### Changed
+
+- Update tenex-edge launch commands (cc304e2)
+
 ## 0.1.6 - 2026-07-06
 
 Changes since `v0.1.5`.

package/README.md

@@ -7,7 +7,7 @@ agent profile instead of a skill.
 Supported sources are GitHub repos, Git URLs, or local checkouts that use the
 agent-profile source layout. Profiles are read from YAML or Markdown files under
 `agents/<slug>/`, adapted for the selected harness, and installed into the
-right place for Codex, Claude Code, OpenCode, or tenex-edge.
+right place for Codex, Claude Code, OpenCode, Goose, or tenex-edge.
 
 ## Install And Run
 
@@ -46,7 +46,7 @@ Useful install options:
 - omit a profile selector in an interactive terminal to choose source profiles
   from a checkbox list; every profile is selected by default
 - `--yes` to accept detected profile and harness selections without opening selectors
-- `--harness codex|claude-code|opencode|tenex-edge|*` to select target harnesses;
+- `--harness codex|claude-code|opencode|goose|tenex-edge|*` to select target harnesses;
   without it, the CLI detects harness CLIs on `PATH`; interactive multi-detect
   opens a checkbox selector with every detected harness selected, and
   noninteractive installs use every detected harness. If none are detected, pass
@@ -60,8 +60,8 @@ Useful install options:
 Human-readable output uses subtle ANSI color. Set `NO_COLOR=1` to disable color,
 or pass `--json` for machine-readable output. After an install, the CLI groups
 run commands by profile for target harness CLIs it finds on `PATH`, such as
-`codex --profile <profile>`, `claude --agent <profile>`, or
-`tenex-edge launch <profile>`.
+`codex --profile <profile>`, `claude --agent <profile>`,
+`tenex-edge launch <profile>`, or `goose session` then `@<profile>`.
 
 ## Harness Targets
 
@@ -70,6 +70,7 @@ Project installs write to:
 - Codex: not supported; Codex profiles load from user config
 - Claude Code: `.claude/agents/<profile>.md`
 - OpenCode: `.opencode/agents/<profile>.md`
+- Goose: `.agents/agents/<profile>.md`
 - tenex-edge: not supported; tenex-edge agents are machine-local
 
 Global installs write to:
@@ -77,6 +78,7 @@ Global installs write to:
 - Codex: `$CODEX_HOME/<profile>.config.toml`, or `~/.codex/<profile>.config.toml`
 - Claude Code: `$CLAUDE_HOME/agents/<profile>.md`, or `~/.claude/agents/<profile>.md`
 - OpenCode: `$OPENCODE_CONFIG_DIR/agents/<profile>.md`, or `~/.config/opencode/agents/<profile>.md`
+- Goose: `$GOOSE_HOME/agents/<profile>.md`, or `~/.agents/agents/<profile>.md`
 - tenex-edge: `$TENEX_EDGE_HOME/agents/<profile>.json`, or `~/.tenex-edge/agents/<profile>.json`
 
 The CLI keeps its own registry at `.awesome-agents/installed.json` for project
@@ -84,6 +86,11 @@ installs or `~/.awesome-agents/installed.json` for global installs. `list`,
 `remove`, and `update` use this registry and refuse to overwrite or delete files
 that do not contain the generated marker unless `--force` is passed.
 
+Agent-owned references and scripts are installed under
+`~/.agents/homes/<profile>/`. Every installed harness profile receives the exact
+agent-home and support-root paths in its operating context, so profile instructions
+can refer to bundled resources by relative path without becoming harness-specific.
+
 Run Codex profiles with:
 
 ```bash

package/docs/cli.md

@@ -19,7 +19,9 @@ all detected selections without prompting. Installs default to project scope
 where the selected harness supports project-local profiles. Codex and tenex-edge
 are exceptions: Codex `--profile` loads named config layers from `CODEX_HOME`,
 while tenex-edge agents live in its machine keystore under
-`$TENEX_EDGE_HOME/agents/` or `~/.tenex-edge/agents/`.
+`$TENEX_EDGE_HOME/agents/` or `~/.tenex-edge/agents/`. Goose uses
+`~/.agents/agents/<profile>.md` (global) or `.agents/agents/<profile>.md`
+(project).
 
 ## Source Resolution
 
@@ -57,11 +59,11 @@ npx awesome-agents add owner/repo --agent triage-agent --harness opencode
 ```
 
 For backward compatibility, `--agent codex`, `--agent claude-code`,
-`--agent opencode`, and `--agent tenex-edge` are still accepted as harness
+`--agent opencode`, `--agent goose`, and `--agent tenex-edge` are still accepted as harness
 selectors.
 
 When no harness selector is provided, `add` detects `codex`, `claude`,
-`opencode`, and `tenex-edge` on `PATH`. If none are found, the command fails and
+`opencode`, `goose`, and `tenex-edge` on `PATH`. If none are found, the command fails and
 asks for `--harness`.
 
 When no profile selector is provided in an interactive terminal, `add` prompts
@@ -83,9 +85,12 @@ installed profile through any matching harness CLI found on `PATH`. Examples:
 ```bash
 codex --profile triage-agent
 claude --agent triage-agent
+goose session
 tenex-edge launch triage-agent
 ```
 
+For Goose, start `goose session` and invoke the agent by name with `@<profile>`.
+
 ## Install Safety
 
 Generated files contain the marker `Generated by awesome-agents`. The CLI refuses

package/docs/plans/public-builder-profiles-agent-model-cards/plan.md

@@ -0,0 +1,105 @@
+# Public Builder Profiles And Agent Model Cards
+
+## Summary
+
+Add the first public site slice for builder profiles and repository-scoped agent model cards, using GitHub identity assumptions and README-backed content where available while keeping the CLI source format repo-neutral.
+
+## Boundaries
+
+```mermaid
+flowchart LR
+  GitHub[GitHub identity] --> Builder[Builder profile /handle]
+  Repo[Agent source repo] --> AgentYaml[agents/slug/agent.yaml]
+  Repo --> Readme[optional agents/slug/README.md]
+  AgentYaml --> Card[Model card route]
+  Readme --> Card
+  Builder --> Card
+  Card --> Install[npx awesome-agents add owner/repo --agent slug]
+  User[Logged-in user] --> Reviews[Reviews later persisted by backend]
+  Reviews --> Card
+```
+
+## Detailed Plan
+
+## Summary
+
+Implement the first public social-profile slice for `awesome-agents.com`: a builder profile route and repository-scoped agent model-card route. Keep it frontend-first and static-data-backed in this repo, while documenting the future backend contract for GitHub login, handle claiming, ownership verification, and reviews.
+
+## Implementation Scope
+
+1. Add site data structures for builders, repos, and agent cards.
+2. Add `/pablof7z` style builder route support through `site/vercel.json` rewrites and a static page/controller.
+3. Add `/pablof7z/touch-grass/chief-of-staff` style model-card route support.
+4. Preserve the existing `/agents/:slug` page as compatibility or redirect-like behavior where practical.
+5. Render optional README-backed model-card content when available in seeded data; render generated fallback sections when absent.
+6. Add visible login/claim/review affordances as nonfunctional or mocked states only if clearly labeled by behavior, not by insecure fake auth.
+7. Use the requested high-design frontend direction for the profile/model-card surfaces while keeping controls usable and text readable.
+
+## Backend Boundary
+
+Future GitHub auth should request basic profile and email access only, such as `read:user` plus `user:email`. The persisted user identity should include GitHub id, login, display name, avatar URL, and verified email where available. Handle claims are first-come-first-served. Repo ownership verification should be done through GitHub identity or GitHub App installation, not through user-entered claims alone. Reviews should require login; MVP has no spam filtering.
+
+## Rollout
+
+Ship the static route/content slice first. Keep existing directory links working. Once the UX holds up, add backend endpoints for auth callback, session, handle claims, repo imports, and review creation.
+
+## Validation
+
+Run `npm run lint` and `npm test` for the Node package. For site work, serve `site/` locally and inspect desktop and mobile routes with Playwright or a browser. Verify no horizontal overflow, route rewrites resolve, copy buttons still work, and old `/agents/:slug` pages are not broken.
+
+## Rollback
+
+Because the first slice is static, rollback is removing the new site page/controller/data entries and rewrites. CLI behavior should remain unaffected.
+
+## Observability
+
+No runtime observability is needed for the static slice. Future backend work should log OAuth callback failures, handle-claim conflicts, repo import failures, and review creation outcomes without logging tokens or private email values unnecessarily.
+
+## Migration
+
+No data migration is required for the first slice. Future migration should reserve existing GitHub usernames as default handles only when a user signs in or claims them, because handle policy is first-come-first-served.
+
+## Risks
+
+The main risk is making the prototype look like real auth or real persisted reviews. Keep those boundaries visually clear. The second risk is route collision between docs, assets, agent compatibility routes, and builder handles; rewrites should reserve known top-level paths before treating a path as a handle.
+
+## Open Questions
+
+Should launch support custom handles beyond GitHub usernames? Which metrics are platform-verified versus self-reported? What review moderation controls should be added once real volume exists?
+
+## Rule And ADR Check
+
+- Respects AGENTS.md by keeping runtime CLI behavior in `src/` untouched for the first site slice.
+- Preserves source independence: no runtime CLI behavior, tests, or examples should hard-code one source repository.
+- Matches product docs: README model-card content is optional, GitHub login requests basic profile plus email, reviews have no MVP spam filtering, and handles are first-come-first-served.
+- Keeps examples that can write user directories behind dry-run or outside CLI examples.
+
+## Possible Rule Or ADR Loosening
+
+- No existing rule needs loosening for the frontend prototype.
+- A future backend may need a new repository rule separating public site source fixtures from runtime CLI source fixtures so real showcased builders do not leak into CLI tests.
+
+## Possible Rule Tightening
+
+- Consider adding a rule that public site routes must prefer repo-neutral fixtures unless a page intentionally demonstrates a real claimed profile.
+- Consider requiring auth-related docs to name requested OAuth scopes and stored identity fields before any backend implementation lands.
+
+## Alternatives Considered
+
+- Full backend now: enables real login and reviews, but expands scope into persistence, secrets, deployment, and security before route/content UX is validated.
+- Only update product docs: too slow for the user's request to start building and does not test whether the social profile concept works on the site.
+- Replace the existing directory with social profiles immediately: cleaner long-term shape, but risks breaking current static pages and install-directory behavior.
+
+## Certainty
+
+86 percent.
+
+## Decision
+
+ready
+
+## Hosted Artifacts
+
+- Plan page: https://pablof7z.github.io/awesome-agents/plans/public-builder-profiles-agent-model-cards/
+
+- TTS audio: https://blossom.primal.net/2faa2fde8c6b962e1b629f2fb2e212aa6fd5e2e61b07e89e43c63475e0d8c195.mp3

package/docs/product/README.md

@@ -11,7 +11,8 @@ unless the user confirms them.
 - `product-scope.md`: What `awesome-agents` is for and how it differs from skills.
 - `command-model.md`: Command shape, `npx skills` parity, defaults, and scriptability.
 - `profile-source-format.md`: Source repositories, canonical profiles, adapters, and install sources.
-- `harness-targets.md`: Codex, Claude Code, OpenCode, and tenex-edge rendering/target behavior.
+- `site-profiles-and-model-cards.md`: Public builder profiles, agent model cards, GitHub login, and README-backed site content.
+- `harness-targets.md`: Codex, Claude Code, OpenCode, Goose, and tenex-edge rendering/target behavior.
 - `safety-and-publishing.md`: Install safety, registry behavior, verification, and npm/GitHub publish state.
 - `open-questions.md`: Unresolved product questions.
 

package/docs/product/command-model.md

@@ -24,8 +24,8 @@ The CLI supports:
   language such as `npx awesome-agents add owner/repo --agent triage-agent`.
 - `--profile <slug>` to select profiles explicitly.
 - `--skill <slug>` as a compatibility alias, even though the artifact is a profile.
-- `--harness <codex|claude-code|opencode|tenex-edge|*>` to select target harnesses.
-- `--agent <codex|claude-code|opencode|tenex-edge|*>` remains accepted as a
+- `--harness <codex|claude-code|opencode|goose|tenex-edge|*>` to select target harnesses.
+- `--agent <codex|claude-code|opencode|goose|tenex-edge|*>` remains accepted as a
   legacy harness selector when the value is a known harness or harness alias.
 - `--all` to install every profile.
 - `--list` to inspect source profiles before installing.
@@ -39,8 +39,8 @@ Accepted implementation decision:
   `$CODEX_HOME/<name>.config.toml`. tenex-edge is also global because invitable
   local agents live under `$TENEX_EDGE_HOME/agents/` or `~/.tenex-edge/agents/`.
 - When no `--harness` or legacy harness-valued `--agent` is provided, the CLI
-  detects supported harness CLIs on `PATH` (`codex`, `claude`, `opencode`, and
-  `tenex-edge`).
+  detects supported harness CLIs on `PATH` (`codex`, `claude`, `opencode`,
+  `goose`, and `tenex-edge`).
 - If one harness is detected, install to it. If multiple harnesses are detected,
   interactive installs open a checkbox selector with every detected harness
   selected by default; noninteractive, `--json`, and `--yes` installs use every

package/docs/product/harness-targets.md

@@ -9,6 +9,7 @@ Initial harness targets:
 - Codex
 - Claude Code
 - OpenCode
+- Goose
 - tenex-edge
 
 ## Codex
@@ -54,6 +55,29 @@ Generated OpenCode agents install to:
 
 OpenCode output is Markdown with frontmatter and a generated marker.
 
+## Goose
+
+Generated Goose custom agents install to:
+
+- Project: `.agents/agents/<profile>.md`
+- Global: `$GOOSE_HOME/agents/<profile>.md`, or `~/.agents/agents/<profile>.md`
+
+Run with:
+
+```bash
+goose session
+```
+
+Then invoke the agent by name in the chat session:
+
+```
+@<profile>
+```
+
+Goose output is Markdown with YAML frontmatter (`name`, `description`, optional
+`model`) and a generated marker. The agent body reuses the Claude Code adapter
+when a Goose-specific adapter is not present.
+
 ## tenex-edge
 
 Generated tenex-edge agents install to:
@@ -70,13 +94,16 @@ tenex-edge launch <profile>
 The generated JSON is a tenex-edge local agent keystore entry with:
 
 - a generated Nostr keypair, preserved across reinstalls
-- `command: ["claude"]`
-- an inline Claude `agent` definition passed by tenex-edge as `--agents`
+- `commands` entries with launch argv that load the installed profile, such as
+  `codex --profile <profile>` or `claude --agent <profile>`
+- an inline Claude `agent` definition passed by tenex-edge as `--agents` for
+  the generated fallback command when no Claude Code profile command is present
 - a byline derived from the profile summary
 
 ## Adapter Gaps
 
 Some source repositories may provide Codex adapters first. Claude Code and
 OpenCode use generated defaults unless a source repository adds native adapters
-for those harnesses. tenex-edge uses a native adapter when present, otherwise it
+for those harnesses. Goose reuses the Claude Code adapter when no Goose-specific
+adapter is present. tenex-edge uses a native adapter when present, otherwise it
 reuses the Claude Code adapter before falling back to the base profile.

package/docs/product/open-questions.md

@@ -14,6 +14,12 @@ These are unresolved product questions for `awesome-agents`.
 - Should remote installs record commit pins or lockfiles for reproducible updates?
 - Should there eventually be a registry or curated index of profile sources?
 
+## Site And Identity
+
+- Should public builder handles always begin as GitHub usernames, or should
+  custom handles be supported from the start?
+- What moderation or spam controls should be added after real review volume?
+
 ## Harness Support
 
 - Should future versions also support Codex custom-agent files in addition to

package/docs/product/product-scope.md

@@ -9,7 +9,7 @@ These notes capture what `awesome-agents` is and why it exists.
 - Its command structure should mirror `npx skills`, but for agent profiles.
 - It should install profiles from any explicit source repository that follows
   the `agents/<slug>/agent.yaml` source layout.
-- Harness targets are Codex, Claude Code, OpenCode, and tenex-edge.
+- Harness targets are Codex, Claude Code, OpenCode, Goose, and tenex-edge.
 - The package should be published after the scaffold works.
 
 ## Product Boundary

package/docs/product/profile-source-format.md

@@ -10,6 +10,7 @@ The source format is intentionally repo-neutral:
 agents/
   <profile>/
     agent.yaml
+    README.md  # optional site model-card body
     skills/
     scripts/
     references/
@@ -28,6 +29,17 @@ agents/<profile>/scripts/*
 agents/<profile>/references/*
 ```
 
+Optional site-facing documentation lives at:
+
+```text
+agents/<profile>/README.md
+```
+
+This README is intended for the public model-card page on
+`awesome-agents.com/<handle>/<repo>/<profile>`. It complements the runtime
+profile definition; it should not be treated as the installable prompt. It is
+not required for a valid source profile.
+
 Immediately relevant skills can be declared in the profile definition:
 
 ```yaml
@@ -60,6 +72,9 @@ Agent-owned scripts and references should be installed into
 `~/.agents/homes/<profile>/references`.
 Declared skills should be installed into
 `~/.agents/homes/<profile>/skills/<skill>`.
+Installed harness profiles receive the exact agent-home, references, and scripts
+paths in their operating context. Source instructions should refer to these resources
+by relative path instead of embedding a harness-specific or checkout-specific path.
 
 Profile source files are intentionally under `agents/`, not `skills/`, because
 the source format models agent profiles separately from loadable skills.

package/docs/product/site-profiles-and-model-cards.md

@@ -0,0 +1,135 @@
+# Site Profiles And Model Cards
+
+These notes capture the requested direction for the public
+`awesome-agents.com` experience.
+
+## Core Direction
+
+The site should become a social profile and discovery index for people who
+build with agent fleets, not only a static CLI directory.
+
+Primary route shape:
+
+```text
+awesome-agents.com/<handle>
+awesome-agents.com/<handle>/<repo>/<agent-slug>
+```
+
+`/<handle>` is a builder profile: a public place to show the operator behind the
+agents. It should include owned profiles, agent fleets, source repos, installs,
+shipped examples, reviews, and activity.
+
+This page should feel closer to a GitHub profile than a landing page. The core
+content is profile information: about details, connected repos, agent templates,
+recent activity, artifacts created with specific fleets, reviews,
+discussion/forum participation, and cross-references between builders, agents,
+and artifacts.
+
+`/<handle>/<repo>/<agent-slug>` is an agent template page, comparable to a
+Hugging Face model card. It should show what the agent is, why it exists, how to
+install it, where its source lives, and what other users say about it.
+
+This page should feel closer to a repository page than a marketing page. Users
+should be able to inspect the template, install or download it, eventually fork
+it, comment on it, review it, and see artifacts shared by other builders who
+used or adapted the agent.
+
+Profile and model-card navigation should be route-backed subpages, not in-page
+anchor tabs. For example:
+
+```text
+awesome-agents.com/<handle>/agents
+awesome-agents.com/<handle>/artifacts
+awesome-agents.com/<handle>/activity
+awesome-agents.com/<handle>/<repo>/<agent-slug>/reviews
+awesome-agents.com/<handle>/<repo>/<agent-slug>/forks
+```
+
+## Agent Model Card Source
+
+Agent source repositories should support optional site-facing README content
+next to the runtime profile definition:
+
+```text
+agents/
+  <agent-slug>/
+    agent.yaml
+    README.md  # optional site model-card body
+    scripts/
+    references/
+```
+
+`agents/<agent-slug>/README.md` is not required. When present, it is the
+canonical source for the public model-card body on the site. It complements
+`agent.yaml`; it is not the runtime prompt. The YAML profile remains the
+installable agent definition, while the README can explain intended use,
+operating model, examples, limitations, changelog notes, and other human-facing
+documentation.
+
+The site should render this README on the model-card route when it exists:
+
+```text
+awesome-agents.com/<handle>/<repo>/<agent-slug>
+```
+
+When no README exists, the site should still allow the agent page and generate a
+fallback model card from `agent.yaml` metadata and profile content.
+
+## Identity And Login
+
+GitHub login is the preferred starting point.
+
+Initial identity assumptions:
+
+- The public handle can default to the GitHub username.
+- Requested GitHub OAuth access should be limited to basic user profile and
+  email address information, such as `read:user` plus `user:email`.
+- GitHub auth can verify repo ownership and let builders claim/import agent
+  source repositories.
+- Repo and agent routes should be derived from GitHub ownership plus the
+  `agents/<agent-slug>/` layout.
+- Reviews should require a logged-in identity.
+- Public handle claims are first-come-first-served.
+
+## Social Surface
+
+Builder profiles should make agent operation legible and impressive without
+turning into a conventional resume page.
+
+Useful signals:
+
+- published agent templates;
+- repos connected to the builder;
+- recent activity related to agent work;
+- artifacts the builder publishes, including which fleet produced them;
+- fleet or team size where the builder chooses to disclose it;
+- installs, stars, reviews, and shipped samples;
+- badges for verified GitHub ownership or claimed source repos;
+- featured agents and examples of work produced with them;
+- discussion/forum participation that can reference builders, repos, agents,
+  and artifacts.
+
+Useful profile metrics:
+
+- agent templates published or maintained;
+- installs across templates and source repos;
+- forks, remixes, and adaptations by other builders;
+- artifacts shipped with explicit fleet tags;
+- average review score from logged-in users;
+- discussion karma or useful answers;
+- verified source ownership and verified artifact links.
+
+Agent model cards should support reviews and reputation signals so users can
+judge an agent before installing it.
+
+The first release should not include spam filtering for reviews. Reviews can
+ship with logged-in identity as the baseline constraint, then add moderation
+controls only after there is real usage pressure.
+
+## Open Questions
+
+- Which metrics are verified by the platform versus self-reported by builders?
+- Should custom handles be supported at launch, or should the first version use
+  GitHub usernames only?
+- What later moderation or spam controls are needed once real review volume
+  exists?

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "awesome-agents",
-  "version": "0.1.6",
-  "description": "Install reusable agent profiles into Codex, Claude Code, OpenCode, and tenex-edge.",
+  "version": "0.1.9",
+  "description": "Install reusable agent profiles into Codex, Claude Code, OpenCode, Goose, and tenex-edge.",
   "type": "module",
   "bin": {
     "awesome-agents": "bin/awesome-agents.js"
@@ -28,6 +28,7 @@
     "codex",
     "claude-code",
     "opencode",
+    "goose",
     "cli"
   ],
   "author": "Pablo Fernandez",

package/scripts/release.js

@@ -28,10 +28,6 @@ async function main() {
   const nextVersion = resolveNextVersion(currentVersion, options.bump);
   const tag = `v${nextVersion}`;
 
-  if (!options.dryRun) {
-    assertCleanWorktree();
-  }
-
   console.log(`Release plan: ${currentVersion} -> ${nextVersion}`);
 
   if (options.dryRun) {

package/src/cli.js

@@ -17,7 +17,7 @@ export async function run(argv = process.argv) {
   const program = new Command();
   program
     .name(PACKAGE_NAME)
-    .description("Install reusable agent profiles into Codex, Claude Code, OpenCode, and tenex-edge.")
+    .description("Install reusable agent profiles into Codex, Claude Code, OpenCode, Goose, and tenex-edge.")
     .version(PACKAGE_VERSION, "-v, --version")
     .helpOption("-h, --help", "Show this help message")
     .showHelpAfterError();

package/src/constants.js

@@ -1,7 +1,7 @@
 export const PACKAGE_NAME = "awesome-agents";
-export const PACKAGE_VERSION = "0.1.6";
+export const PACKAGE_VERSION = "0.1.9";
 export const DEFAULT_AGENT = "codex";
-export const SUPPORTED_AGENTS = ["codex", "claude-code", "opencode", "tenex-edge"];
+export const SUPPORTED_AGENTS = ["codex", "claude-code", "opencode", "goose", "tenex-edge"];
 export const REGISTRY_DIRNAME = ".awesome-agents";
 export const REGISTRY_FILENAME = "installed.json";
 export const GENERATED_MARKER = "Generated by awesome-agents";
@@ -15,6 +15,7 @@ export const AGENT_ALIASES = new Map([
   ["claudecode", "claude-code"],
   ["opencode", "opencode"],
   ["open-code", "opencode"],
+  ["goose", "goose"],
   ["tenex", "tenex-edge"],
   ["tenex-edge", "tenex-edge"],
   ["tenexedge", "tenex-edge"]
@@ -25,5 +26,6 @@ export const HARNESS_COMMANDS = new Map([
   ["codex", "codex"],
   ["claude-code", "claude"],
   ["opencode", "opencode"],
+  ["goose", "goose"],
   ["tenex-edge", "tenex-edge"]
 ]);

package/src/help.js

@@ -188,13 +188,13 @@ const banner = [
   color("                       | (_| | (_| |  __/ | | | |_\\__ \\  ", codes.bannerB),
   color("                        \\__,_|\\__, |\\___|_| |_|\\__|___/  ", codes.bannerA),
   color("                              |___/                       ", codes.bannerA),
-  `  ${ui.dim("Operational profiles for Codex, Claude Code, OpenCode, and tenex-edge")}`
+  `  ${ui.dim("Operational profiles for Codex, Claude Code, OpenCode, Goose, and tenex-edge")}`
 ];
 
 const mainHelp = {
   banner,
   usage: `${PACKAGE_NAME} <command> [options]`,
-  description: "Install reusable operational agent profiles into Codex, Claude Code, OpenCode, and tenex-edge.",
+  description: "Install reusable operational agent profiles into Codex, Claude Code, OpenCode, Goose, and tenex-edge.",
   sections: [
     {
       title: "Manage Profiles:",
@@ -290,7 +290,7 @@ const commandHelp = {
         rows: [
           "1. Read canonical definitions from agents/<slug>/agent.yaml or compatible variants.",
           "2. Install agent-owned scripts, references, and declared skills into ~/.agents/homes/<slug>/.",
-          "3. Render Codex, Claude Code, OpenCode, or tenex-edge files and record them in the registry."
+          "3. Render Codex, Claude Code, OpenCode, Goose, or tenex-edge files and record them in the registry."
         ]
       },
       {
@@ -330,6 +330,7 @@ const commandHelp = {
           { term: ui.command("codex"), description: `${ui.path("~/.codex/<profile>.config.toml")} (project-local Codex profiles are not supported)` },
           { term: ui.command("claude-code"), description: `${ui.path("~/.claude/agents/<profile>.md")} or ${ui.path(".claude/agents/<profile>.md")}` },
           { term: ui.command("opencode"), description: `${ui.path("~/.config/opencode/agents/<profile>.md")} or ${ui.path(".opencode/agents/<profile>.md")}` },
+          { term: ui.command("goose"), description: `${ui.path("~/.agents/agents/<profile>.md")} or ${ui.path(".agents/agents/<profile>.md")}` },
           { term: ui.command("tenex-edge"), description: `${ui.path("~/.tenex-edge/agents/<profile>.json")} (project-local tenex-edge agents are not supported)` },
           { term: ui.command("registry"), description: `${ui.path("~/.awesome-agents/installed.json")} or ${ui.path(".awesome-agents/installed.json")}` }
         ]

package/src/installer.js

@@ -36,10 +36,17 @@ export async function installFromSource(sourceSpec, options = {}) {
     const installedAt = new Date().toISOString();
 
     for (const profile of profiles) {
+      const agentHome = resolveAgentHome(profile, options);
       const supportTargets = await installProfileSupport(profile, options);
+      const supportRoots = (profile.supportDirs ?? []).map((supportDir) => ({
+        kind: supportDir.kind,
+        path: path.join(agentHome, supportDir.kind)
+      }));
       const installedSkills = await installProfileSkills(profile, materialized.path, options);
       const renderProfile = {
         ...profile,
+        agentHome,
+        supportRoots,
         installedSkills
       };
       for (const harness of harnesses) {
@@ -47,7 +54,8 @@ export async function installFromSource(sourceSpec, options = {}) {
         const existingContent = await readExistingContent(target);
         const content = renderForAgent(renderProfile, harness, {
           source: materialized.source,
-          existingContent
+          existingContent,
+          selectedHarnesses: harnesses
         });
         await writeManagedFile(target, content, options);
 
@@ -62,6 +70,8 @@ export async function installFromSource(sourceSpec, options = {}) {
           target,
           installedAt,
           contentSha256: contentHash(content),
+          agentHome,
+          supportRoots,
           supportTargets,
           skillTargets: installedSkills.map((skill) => skill.path),
           installedSkills,
@@ -252,8 +262,7 @@ async function installProfileSupport(profile, options = {}) {
     return [];
   }
 
-  const home = path.resolve(expandHome(options.home ?? os.homedir()));
-  const agentHome = path.join(home, ".agents", "homes", profile.slug);
+  const agentHome = resolveAgentHome(profile, options);
   const targets = [];
 
   for (const supportDir of profile.supportDirs) {
@@ -272,6 +281,11 @@ async function installProfileSupport(profile, options = {}) {
   return targets;
 }
 
+function resolveAgentHome(profile, options = {}) {
+  const home = path.resolve(expandHome(options.home ?? os.homedir()));
+  return path.join(home, ".agents", "homes", profile.slug);
+}
+
 async function listFilesRecursive(root) {
   const entries = await fs.readdir(root, { withFileTypes: true });
   const files = [];
@@ -354,6 +368,20 @@ function runInstructionForOperation(operation, env) {
     };
   }
 
+  if (operation.harness === "goose") {
+    if (!commandExists("goose", env)) {
+      return undefined;
+    }
+    return {
+      profile: operation.profile,
+      name: operation.name,
+      summary: operation.summary,
+      harness: operation.harness,
+      command: "goose session",
+      note: `Start goose, then invoke @${operation.profile} in the session.`
+    };
+  }
+
   if (operation.harness === "tenex-edge") {
     if (!commandExists("tenex-edge", env)) {
       return undefined;

package/src/renderers.js

@@ -41,6 +41,9 @@ export function renderForAgent(profile, agent, context) {
   if (normalized === "opencode") {
     return renderOpenCode(profile, context);
   }
+  if (normalized === "goose") {
+    return renderGoose(profile, context);
+  }
   if (normalized === "tenex-edge") {
     return renderTenexEdge(profile, context);
   }
@@ -88,6 +91,19 @@ export function resolveTargetPath(profile, agent, options = {}) {
     return path.join(opencodeHome, "agents", `${profile.slug}.md`);
   }
 
+  if (normalized === "goose") {
+    if (scope === "project") {
+      return path.join(cwd, ".agents", "agents", `${profile.slug}.md`);
+    }
+
+    const gooseHome = options.gooseHome
+      ? path.resolve(expandHome(options.gooseHome, home))
+      : process.env.GOOSE_HOME
+        ? path.resolve(expandHome(process.env.GOOSE_HOME, home))
+        : path.join(home, ".agents");
+    return path.join(gooseHome, "agents", `${profile.slug}.md`);
+  }
+
   if (normalized === "tenex-edge") {
     const tenexEdgeHome = options.tenexEdgeHome
       ? path.resolve(expandHome(options.tenexEdgeHome, home))
@@ -171,9 +187,45 @@ function renderOpenCode(profile, context) {
   return stringifyFrontmatter(attributes, `${marker}\n\n${buildInstructionBody(profile, undefined, "opencode")}`);
 }
 
+function renderGoose(profile, context) {
+  const attributes = {
+    name: profile.slug,
+    description: profile.summary || profile.name
+  };
+  const model = chooseGooseModel(profile);
+  if (model && model !== "inherit") {
+    attributes.model = model;
+  }
+
+  const marker = htmlMarker(profile, "goose", context);
+  return stringifyFrontmatter(attributes, `${marker}\n\n${buildInstructionBody(profile, profile.adapters.goose ?? profile.adapters["claude-code"], "goose")}`);
+}
+
 function renderTenexEdge(profile, context) {
   const existing = tenexEdgeKeyMaterial(context.existingContent);
   const keyMaterial = existing ?? generateNostrKeypair();
+  const commands = tenexEdgeCommands(profile, context);
+  const agent = tenexEdgeInlineAgent(profile);
+
+  const stored = {
+    slug: profile.slug,
+    secret_key: keyMaterial.secret_key,
+    public_key: keyMaterial.public_key,
+    created_at: keyMaterial.created_at ?? Math.floor(Date.now() / 1000),
+    commands,
+    byline: profile.summary || profile.name,
+    managed_by: GENERATED_MARKER,
+    source: context.source
+  };
+
+  if (hasInlineClaudeCommand(commands)) {
+    stored.agent = agent;
+  }
+
+  return `${JSON.stringify(stored, null, 2)}\n`;
+}
+
+function tenexEdgeInlineAgent(profile) {
   const agent = {
     description: profile.summary || profile.name,
     prompt: buildInstructionBody(profile, profile.adapters["tenex-edge"] ?? profile.adapters["claude-code"], "tenex-edge")
@@ -188,19 +240,43 @@ function renderTenexEdge(profile, context) {
     agent.effort = effort;
   }
 
-  const stored = {
-    slug: profile.slug,
-    secret_key: keyMaterial.secret_key,
-    public_key: keyMaterial.public_key,
-    created_at: keyMaterial.created_at ?? Math.floor(Date.now() / 1000),
-    command: ["claude"],
-    agent,
-    byline: profile.summary || profile.name,
-    managed_by: GENERATED_MARKER,
-    source: context.source
-  };
+  return agent;
+}
 
-  return `${JSON.stringify(stored, null, 2)}\n`;
+function tenexEdgeCommands(profile, context) {
+  const commands = [];
+  for (const harness of arrayify(context.selectedHarnesses)) {
+    if (harness === "codex") {
+      commands.push({
+        name: "codex",
+        argv: ["codex", "--profile", profile.slug]
+      });
+    } else if (harness === "claude-code") {
+      commands.push({
+        name: "claude",
+        argv: ["claude", "--agent", profile.slug]
+      });
+    }
+  }
+
+  // Keep tenex-edge-only installs self-contained. tenex-edge expands this with
+  // the inline `agent` definition as `claude --agents ... --agent <slug>`.
+  if (!commands.some((command) => command.name === "claude")) {
+    commands.push({
+      name: "claude",
+      argv: ["claude"]
+    });
+  }
+
+  return uniqueBy(commands, (command) => command.name);
+}
+
+function hasInlineClaudeCommand(commands) {
+  return commands.some((command) => (
+    command.name === "claude" &&
+    command.argv.length === 1 &&
+    command.argv[0] === "claude"
+  ));
 }
 
 function buildInstructionBody(profile, adapter, harness) {
@@ -214,9 +290,24 @@ function buildInstructionBody(profile, adapter, harness) {
     `- Installed for: \`${harness}\``,
     "- When asked who you are, what agent is running, or what role you are acting as, answer with this identity and role.",
     "- This profile is a reusable operational agent profile, not a skill or local machine setup.",
-    "- The runtime agent manages any profile-specific home directory and notes at task time."
+    profile.agentHome
+      ? `- Agent home: \`${profile.agentHome}\``
+      : "- This render-only output does not install an agent home or support material."
   ];
 
+  if (profile.supportRoots?.length) {
+    parts.push(
+      "",
+      "## Agent-Owned Support",
+      "",
+      "Use these installed resources when the operating procedure calls for them. Resolve relative support paths against these roots.",
+      ""
+    );
+    for (const support of profile.supportRoots) {
+      parts.push(`- \`${support.kind}\`: \`${support.path}\``);
+    }
+  }
+
   if (profile.installedSkills?.length) {
     const skillBase = path.join(path.dirname(profile.installedSkills[0].path), "<skill>");
     parts.push(
@@ -277,6 +368,27 @@ function chooseOpenCodeModel(profile) {
   return candidates.find((model) => model.includes("/"));
 }
 
+function chooseGooseModel(profile) {
+  const candidates = [
+    profile.attributes.recommended_model,
+    ...arrayify(profile.attributes.recommended_models)
+  ].filter(Boolean).map((value) => String(value).toLowerCase());
+
+  if (candidates.some((model) => model.includes("opus"))) {
+    return "claude-3-5-sonnet";
+  }
+  if (candidates.some((model) => model.includes("sonnet"))) {
+    return "claude-3-5-sonnet";
+  }
+  if (candidates.some((model) => model.includes("haiku"))) {
+    return "claude-3-5-haiku";
+  }
+  if (candidates.some((model) => model.includes("gpt"))) {
+    return candidates.find((model) => model.includes("gpt"));
+  }
+  return undefined;
+}
+
 function tenexEdgeKeyMaterial(content) {
   if (!content) {
     return undefined;
@@ -358,6 +470,20 @@ function arrayify(value) {
   return [value];
 }
 
+function uniqueBy(values, keyForValue) {
+  const seen = new Set();
+  const out = [];
+  for (const value of values) {
+    const key = keyForValue(value);
+    if (seen.has(key)) {
+      continue;
+    }
+    seen.add(key);
+    out.push(value);
+  }
+  return out;
+}
+
 function flattenValues(values) {
   return arrayify(values)
     .flatMap((value) => String(value).split(","))

package/src/skills.js

@@ -27,26 +27,38 @@ export async function installProfileSkills(profile, sourceRoot, options = {}) {
   const installed = [];
 
   for (const dependency of dependencies) {
-    const skill = await resolveSkillDependency(profile, dependency, sourceRoot, home, options);
-    const target = path.join(home, ".agents", "homes", profile.slug, "skills", skill.installName);
-
-    if (!options.dryRun) {
-      await fs.rm(target, { recursive: true, force: true });
-      await fs.mkdir(path.dirname(target), { recursive: true });
-      await fs.cp(skill.path, target, {
-        recursive: true,
-        dereference: true,
-        preserveTimestamps: true
-      });
+    let resolved;
+    try {
+      resolved = await resolveSkillDependency(profile, dependency, sourceRoot, home, options);
+    } catch (error) {
+      console.warn(`Skipping skill "${dependency.selector ?? dependency.source}" for profile "${profile.slug}": ${error.message}`);
+      continue;
     }
 
-    installed.push({
-      name: skill.installName,
-      declaredName: dependency.selector ?? dependency.source ?? skill.name,
-      source: skill.source,
-      sourceKind: skill.sourceKind,
-      path: target
-    });
+    const { skill, cleanup } = resolved;
+    try {
+      const target = path.join(home, ".agents", "homes", profile.slug, "skills", skill.installName);
+
+      if (!options.dryRun) {
+        await fs.rm(target, { recursive: true, force: true });
+        await fs.mkdir(path.dirname(target), { recursive: true });
+        await fs.cp(skill.path, target, {
+          recursive: true,
+          dereference: true,
+          preserveTimestamps: true
+        });
+      }
+
+      installed.push({
+        name: skill.installName,
+        declaredName: dependency.selector ?? dependency.source ?? skill.name,
+        source: skill.source,
+        sourceKind: skill.sourceKind,
+        path: target
+      });
+    } finally {
+      await cleanup();
+    }
   }
 
   return installed;
@@ -115,6 +127,8 @@ function looksLikeRemoteSource(value) {
   return value.includes("/") || value.includes(":") || value.startsWith("~") || value.startsWith(".");
 }
 
+const NOOP_CLEANUP = async () => {};
+
 async function resolveSkillDependency(profile, dependency, sourceRoot, home, options) {
   if (dependency.source) {
     const materialized = await materializeSource(dependency.source, {
@@ -122,13 +136,15 @@ async function resolveSkillDependency(profile, dependency, sourceRoot, home, opt
       requireAgentProfileLayout: false
     });
     try {
-      return await selectSkillFromRoot(materialized.path, dependency.selector, {
+      const skill = await selectSkillFromRoot(materialized.path, dependency.selector, {
         dependency,
         source: materialized.source,
         sourceKind: materialized.kind
       });
-    } finally {
+      return { skill, cleanup: materialized.cleanup };
+    } catch (error) {
       await materialized.cleanup();
+      throw error;
     }
   }
 
@@ -138,7 +154,7 @@ async function resolveSkillDependency(profile, dependency, sourceRoot, home, opt
     sourceKind: "profile-local"
   });
   if (profileSkill) {
-    return profileSkill;
+    return { skill: profileSkill, cleanup: NOOP_CLEANUP };
   }
 
   const sourceSkill = await findSkillInRoot(sourceRoot, dependency.selector, {
@@ -147,7 +163,7 @@ async function resolveSkillDependency(profile, dependency, sourceRoot, home, opt
     sourceKind: "local-source"
   });
   if (sourceSkill) {
-    return sourceSkill;
+    return { skill: sourceSkill, cleanup: NOOP_CLEANUP };
   }
 
   const userSkillRoot = path.join(home, ".agents", "skills");
@@ -157,7 +173,7 @@ async function resolveSkillDependency(profile, dependency, sourceRoot, home, opt
     sourceKind: "user-skills"
   });
   if (userSkill) {
-    return userSkill;
+    return { skill: userSkill, cleanup: NOOP_CLEANUP };
   }
 
   throw new Error(`Skill "${dependency.selector}" was not found in the profile source or ${userSkillRoot}.`);
@@ -246,7 +262,13 @@ async function discoverSkills(root) {
       return true;
     }
 
-    const skill = await readSkill(skillDir, root);
+    let skill;
+    try {
+      skill = await readSkill(skillDir, root);
+    } catch (error) {
+      console.warn(`Skipping unreadable skill at ${skillDir}: ${error.message}`);
+      return true;
+    }
     if (seenNames.has(skill.installName)) {
       return true;
     }