Skip to content

Conversation

@blackgirlbytes
Copy link
Contributor

This pull request introduces a new experimental feature called "Subagents" to the Goose documentation. Subagents are independent instances designed to execute tasks with process isolation and context preservation. The changes include detailed documentation for this feature, updates to configuration guides, and examples of usage. Additionally, experimental feature settings have been added to the configuration and environment variable documentation.

Subagents Feature Documentation:

  • New Subagents Page: Added a comprehensive guide for Subagents, explaining their purpose, execution types (sequential and parallel), internal and external subagents, use cases, lifecycle, and configuration. Includes examples of direct instructions, recipe-based configurations, and external tool integration. (documentation/docs/experimental/subagents.md)
  • Experimental Features Section: Added a card for Subagents in the experimental features index. (documentation/docs/experimental/index.md)

Configuration Updates:

  • Config File: Added a new ALPHA_FEATURES setting to enable experimental features, including Subagents, in the Goose configuration file. (documentation/docs/guides/config-file.md) [1] [2]
  • Environment Variables: Documented the ALPHA_FEATURES environment variable to enable experimental features, with examples for usage. (documentation/docs/guides/environment-variables.md)

@github-actions
Copy link
Contributor

github-actions bot commented Jul 14, 2025

PR Preview Action v1.6.0
Preview removed because the pull request was closed.
2025-07-15 03:27 UTC

## Internal Subagents
Internal subagents spawn Goose instances to handle tasks using your current session's context and extensions.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Consider mentioning why Direct Instruction and Recipe Configuration are included in this section? e.g. two ways to configure/execute subagents?

}
```

### Recipe Configuration
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This reads like a regular recipe implementation, not sure how it integrates with the subagent

@angiejones angiejones changed the title Docs: Subagents docs: Subagents Jul 15, 2025
@blackgirlbytes blackgirlbytes merged commit fc3d59f into main Jul 15, 2025
9 checks passed
@blackgirlbytes blackgirlbytes deleted the subagents branch July 15, 2025 03:27
lifeizhou-ap added a commit that referenced this pull request Jul 15, 2025
* main:
  fix: convert invalid recipe variable name to raw content (#3420)
  center goose mobile screenshot (#3418)
  docs: model context limit overrides (#3377)
  docs: Subagents (#3402)
  fix: avoid pass encoded empty string to goose run --recipe (#3361)
  ux: alphabetize extensions (#3416)
  fix: message concatenation in server session management (#3412)
  refactor: streamline memory directory management (#3345)
  feat: Add AZURE_OPENAI_API_KEY as a visible config parameter (#3265)
  feat: stream LLM responses (#2677)
  fix checkout for non mac builds (#3408)
  Docs: Voice dictation in Goose Desktop (#3376)
  docs: cli theme persistence (#3398)
  docs: goose mobile (#3403)
zanesq added a commit that referenced this pull request Jul 15, 2025
* 'main' of github.com:block/goose:
  fix: Set include_usage=true for OpenAI streaming (#3441)
  feat: `recipe list` (#2814) (#2815)
  docs: update github mcp config (#3433)
  feat: Implement streaming for OpenAI (#3413)
  fix: improve extension startup error messages with command details (#2694)
  [feat]: improve file search tools to add globsearch / grep tools (#3368)
  docs: typo in guide description (#3429)
  fix: use safe_truncate to truncate charactor (#3263) (#3264)
  fix: convert invalid recipe variable name to raw content (#3420)
  center goose mobile screenshot (#3418)
  docs: model context limit overrides (#3377)
  docs: Subagents (#3402)
  fix: avoid pass encoded empty string to goose run --recipe (#3361)
  ux: alphabetize extensions (#3416)
  fix: message concatenation in server session management (#3412)
  refactor: streamline memory directory management (#3345)
  feat: Add AZURE_OPENAI_API_KEY as a visible config parameter (#3265)
  feat: stream LLM responses (#2677)

# Conflicts:
#	crates/goose/src/session/storage.rs
#	ui/desktop/src/components/ChatView.tsx
#	ui/desktop/src/components/settings/extensions/subcomponents/ExtensionList.tsx
lifeizhou-ap added a commit that referenced this pull request Jul 16, 2025
* main: (54 commits)
  UI update with sidebar and settings tabs (#3288)
  docs: add CLIStreamExtensionInstructions component (#3443)
  chore(release): release version 1.0.36 (#3436)
  [goose-llm] fix image content bug, add optional request_id field (#3439)
  fix: Set include_usage=true for OpenAI streaming (#3441)
  feat: `recipe list` (#2814) (#2815)
  docs: update github mcp config (#3433)
  feat: Implement streaming for OpenAI (#3413)
  fix: improve extension startup error messages with command details (#2694)
  [feat]: improve file search tools to add globsearch / grep tools (#3368)
  docs: typo in guide description (#3429)
  fix: use safe_truncate to truncate charactor (#3263) (#3264)
  fix: convert invalid recipe variable name to raw content (#3420)
  center goose mobile screenshot (#3418)
  docs: model context limit overrides (#3377)
  docs: Subagents (#3402)
  fix: avoid pass encoded empty string to goose run --recipe (#3361)
  ux: alphabetize extensions (#3416)
  fix: message concatenation in server session management (#3412)
  refactor: streamline memory directory management (#3345)
  ...
s-soroosh pushed a commit to s-soroosh/goose that referenced this pull request Jul 18, 2025
Co-authored-by: angiejones <[email protected]>
Signed-off-by: Soroosh <[email protected]>
kwsantiago pushed a commit to kwsantiago/goose that referenced this pull request Jul 19, 2025
Co-authored-by: angiejones <[email protected]>
Signed-off-by: Kyle Santiago <[email protected]>
cbruyndoncx pushed a commit to cbruyndoncx/goose that referenced this pull request Jul 20, 2025
atarantino pushed a commit to atarantino/goose that referenced this pull request Aug 5, 2025
Co-authored-by: angiejones <[email protected]>
Signed-off-by: Adam Tarantino <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants