Repository navigation
feat(circles): let a circle see when you're free, and find a time - #661
Merged
Merged
Conversation
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012v8sNShSVTXxoPDab62A1L
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012v8sNShSVTXxoPDab62A1L
… module imports first Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012v8sNShSVTXxoPDab62A1L
This was referenced Oct 19, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Requested by Adeel · project thread
Description
Before: circles could share items and run sharing rules, but nobody's agent could find out when family members were free, so finding a time for a call meant asking each person.
After: turn on They can see when you're free on a circle (
lets: ["free_busy"]). Its people, or their agents, askPOST /api/v1/circles/when-free, MCPwhen_freeor the assistant for a window of up to 31 days, and get each person's busy times (start and end only, never what, where or with whom) plus the free stretches when everyone is free, within the hours of the day asked for. Each ask shows in the asked person's timeline asagent.asked.How:
domain/circles_ask.pygathers the calendar events a person organises or is invited to, plus every event in a namespace they alone belong to, skipping vaults, and merges busy intervals per person; free stretches are the gaps in the union. No model is called.circles_askloads at the end ofcircles.pyso either module can import first.Motivation and Context
Part of the agent family network (agents find times and schedule calls for each other), the third of the saved circles PRs after #626, #649 and #653.
Types of changes
!in the title)Checklist:
make hookschecks it on commit).docs/accordingly.changelog.d/circles-when-free.md.Done questions (AGENTS.md)
POST /api/v1/circles/when-free, MCPwhen_free, assistantwhen_free.letsis set in the web app and API; off by default.letsdefaults to empty on existing circles, so nothing changes until turned on.test_when_people_are_free), docs and the generated client (make openapi) updated.Generated by Claude Code