Skip to content

docs: document .continue/configs/ directory for local config profiles#12157

Open
octo-patch wants to merge 1 commit intocontinuedev:mainfrom
octo-patch:docs/configs-directory-documentation
Open

docs: document .continue/configs/ directory for local config profiles#12157
octo-patch wants to merge 1 commit intocontinuedev:mainfrom
octo-patch:docs/configs-directory-documentation

Conversation

@octo-patch
Copy link
Copy Markdown
Contributor

@octo-patch octo-patch commented Apr 17, 2026

Fixes #12096
Fixes #12136

Problem

The .continue/configs/ directory was added in PR #11935 as a third location (alongside .continue/agents/ and .continue/assistants/) for local config profiles, but it was never documented.

Solution

Added a new section to docs/customize/deep-dives/configuration.mdx that covers:

  • What the .continue/configs/ directory is and its purpose
  • The difference between workspace-level (.continue/configs/*.yaml) and global-level (~/.continue/configs/*.yaml) profiles
  • A comparison table showing all config locations and their scopes
  • Step-by-step instructions for creating a local profile with an example YAML file
  • Notes on automatic hot-reloading when files are added, edited, or removed

Testing

Documentation-only change; verified the MDX syntax is valid and the content accurately reflects the implementation in core/config/ConfigHandler.ts and core/config/loadLocalAssistants.ts.


Summary by cubic

Adds documentation for the .continue/configs/ directory to create local config profiles at the workspace or global level. Includes a locations/scope comparison, step-by-step setup with example YAML, and notes on automatic discovery and hot-reloading in the sidebar selector.

Written for commit 2b5506d. Summary will update on new commits.

…fixes continuedev#12096, continuedev#12136)

Add documentation for the .continue/configs/ directory feature (added in
PR continuedev#11935). Explains how to create workspace- or global-level config
profiles by placing YAML files in .continue/configs/, how they appear in
the Continue profile picker, and automatic hot-reloading behavior.
@octo-patch octo-patch requested a review from a team as a code owner April 17, 2026 02:12
@octo-patch octo-patch requested review from sestinj and removed request for a team April 17, 2026 02:12
@dosubot dosubot bot added the size:M This PR changes 30-99 lines, ignoring generated files. label Apr 17, 2026
@github-actions
Copy link
Copy Markdown
Contributor


Thank you for your submission, we really appreciate it. Like many open-source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution. You can sign the CLA by just posting a Pull Request Comment same as the below format.


I have read the CLA Document and I hereby sign the CLA


octo-patch seems not to be a GitHub user. You need a GitHub account to be able to sign the CLA. If you have already a GitHub account, please add the email address used for this commit to your account.
You can retrigger this bot by commenting recheck in this Pull Request. Posted by the CLA Assistant Lite bot.

Copy link
Copy Markdown
Contributor

@cubic-dev-ai cubic-dev-ai bot left a comment

Choose a reason for hiding this comment

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

No issues found across 1 file

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size:M This PR changes 30-99 lines, ignoring generated files.

Projects

Status: Todo

Development

Successfully merging this pull request may close these issues.

Docs: Add documentation for .continue/configs/ directory support docs: Document .continue/configs directory for local config profiles

1 participant