From 3d4a20f5c1042b749a569fe233e9fb3bdc42ae0e Mon Sep 17 00:00:00 2001 From: dianed-square <73617011+dianed-square@users.noreply.github.com> Date: Fri, 30 Jan 2026 11:44:18 -0800 Subject: [PATCH] docs: session isolation (#6846) --- documentation/docs/guides/acp-clients.md | 1 + documentation/docs/tutorials/cicd.md | 8 ++++++++ 2 files changed, 9 insertions(+) diff --git a/documentation/docs/guides/acp-clients.md b/documentation/docs/guides/acp-clients.md index 0e2c134136..1b31c60138 100644 --- a/documentation/docs/guides/acp-clients.md +++ b/documentation/docs/guides/acp-clients.md @@ -18,6 +18,7 @@ The client manages the goose lifecycle automatically, including: - **Initialization**: The client runs the `goose acp` command to initialize the connection - **Communication**: The client communicates with goose over stdio using JSON-RPC - **Multiple Sessions**: The client manages multiple concurrent goose conversations simultaneously +- **Session Isolation**: Each session maintains its own isolated state, including conversation history, agent context, and extension configurations, allowing concurrent sessions to run without interference :::info Session Persistence ACP sessions are saved to goose's session history where you can access and manage them using goose. Access to session history in ACP clients might vary. diff --git a/documentation/docs/tutorials/cicd.md b/documentation/docs/tutorials/cicd.md index a41ec9950e..0a783319c6 100644 --- a/documentation/docs/tutorials/cicd.md +++ b/documentation/docs/tutorials/cicd.md @@ -230,6 +230,14 @@ This is just one example of what's possible. Feel free to modify your GitHub Act --- +## Running Multiple goose Instances in Parallel + +goose supports running multiple concurrent sessions with isolated state, making it safe to run parallel jobs in your CI/CD pipeline. Each goose instance maintains its own conversation history, agent context, and extension configurations without interference. + +This enables use cases like matrix builds across different environments or processing multiple components simultaneously. + +--- + ## Security Considerations When running goose in a CI/CD environment, keep these security practices in mind: