Skip to content

Conversation

continue[bot]
Copy link
Contributor

@continue continue bot commented Oct 17, 2025

Summary

This PR adds comprehensive documentation for the file access outside workspace feature introduced in #8298.

Changes

New Documentation

  • New file: docs/ide-extensions/agent/file-access-outside-workspace.mdx
    • Complete guide covering how file access works with path resolution and workspace boundaries
    • Supported path formats: relative, absolute, tilde (~), file:// URIs, and Windows UNC paths
    • Security and permission policies for workspace vs. non-workspace files
    • Best practices and troubleshooting guidance
    • Multiple examples demonstrating various use cases

Documentation Updates

  • docs/ide-extensions/agent/how-it-works.mdx: Added notes about file access outside workspace capabilities to the tools list
  • docs/ide-extensions/plan/how-it-works.mdx: Added notes about file access outside workspace capabilities for Plan mode
  • docs/ide-extensions/agent/how-to-customize.mdx: Added a new section linking to the comprehensive file access guide
  • docs/docs.json: Added the new documentation page to the navigation

Documentation Structure

The new documentation provides:

  1. Overview: How Continue handles file access within and outside workspace
  2. Supported Path Formats: All supported path types with examples
  3. Workspace Boundary Detection: How Continue determines workspace boundaries
  4. Security and Permissions: Permission policies and best practices
  5. Available Tools: Which tools support external file access
  6. Examples: Real-world usage scenarios
  7. Troubleshooting: Common issues and solutions
  8. Related Documentation: Links to related guides

Related PR

This documentation complements the implementation in #8298.


This agent session was co-authored by patrick-erichsen and Continue.


Summary by cubic

Adds path resolution and permission gating for accessing files outside the workspace, and documents how it works. Tools now support absolute, tilde, file://, and UNC paths and request permission when needed.

  • New Features

    • Added core path resolver with workspace boundary detection and tests.
    • Enforced file access policy: outside workspace requires permission; GUI uses preprocessed args.
    • Updated ls, read_file, read_file_range, and view_subdirectory to resolve paths and improve errors; added CLI resolver.
  • Documentation

    • New guide: File Access Outside Workspace (formats, security, examples, troubleshooting).
    • Updated Agent and Plan “How it works” and customization pages; added nav entry.

Patrick-Erichsen and others added 4 commits October 16, 2025 15:56
- Combined resolveInputPath approach with new ContinueError system
- Updated error handling to use ContinueError with appropriate error reasons
- Maintained improved error messages from pe/read-file-errs branch
- Add comprehensive guide at ide-extensions/agent/file-access-outside-workspace.mdx
- Update how-it-works.mdx for Agent mode with file access info
- Update how-it-works.mdx for Plan mode with file access info
- Update how-to-customize.mdx with file access section
- Add new doc page to docs.json navigation

The new documentation covers:
- How file access works with path resolution and workspace boundaries
- Supported path formats (relative, absolute, tilde, file://, UNC)
- Security and permission policies
- Best practices and troubleshooting
- Examples for various use cases

Generated with [Continue](https://continue.dev)

Co-Authored-By: Continue <[email protected]>
Co-authored-by: Username <[email protected]>
@continue continue bot requested a review from a team as a code owner October 17, 2025 00:06
@continue continue bot requested review from sestinj and removed request for a team October 17, 2025 00:06
@dosubot dosubot bot added the size:XL This PR changes 500-999 lines, ignoring generated files. label Oct 17, 2025
Copy link
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 18 files

@sestinj
Copy link
Contributor

sestinj commented Oct 17, 2025

@Patrick-Erichsen I'm marking this as draft bc not sure what the status is

@sestinj sestinj marked this pull request as draft October 17, 2025 16:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size:XL This PR changes 500-999 lines, ignoring generated files.

Projects

Status: Todo

Development

Successfully merging this pull request may close these issues.

2 participants