Skip to content

start_session

Initialize a Polygraph session for the selected repositories.

Clones session worktrees for the given repository IDs and registers the session with Polygraph. Call list_repos first to obtain valid repo IDs, then pass them as selectedRepoIds. An optional setSessionId overrides the auto-generated ID derived from the current git branch name.

NameTypeRequiredDescription
setSessionIdstringnoOverride the auto-generated session ID. Only use this for resuming an existing session or advanced use cases. By default, a unique ID is generated from the local git branch name with a short UUID suffix.
selectedRepoIdsarrayyesRequired list of repo IDs to include in the session. Use list_repos to discover available repos first.