Add PDF file upload support to GitHub Copilot CLI
Nobody has claimed this yet.
- Dominant language
- Shell
- Stars
- 11.2k
- Forks
- 1.9k
- Avg merge
- 14h 16m
- Merged PRs (30d)
- 6
Description
Describe the feature or problem you'd like to solve
Add PDF file upload support to GitHub Copilot CLI
Proposed solution
GitHub Copilot CLI currently does not support uploading or analyzing PDF files through the interface, even though the underlying AI models fully support PDF analysis. Many users and workflows rely on PDF documents (technical documentation, specifications, reports, design files, etc.). This limitation creates friction and forces users to manually extract and paste content instead of directly referencing PDF files.
Benefit: Enabling PDF support would allow users to:
- Reference technical documentation and specifications without manual copying
- Analyze PDF reports and extract key information
- Include design specifications and mockups directly
- Improve workflow efficiency by reducing manual data extraction
- Align CLI capabilities with other Copilot interfaces (VS Code, GitHub.com)
Example prompts or workflows
copilotthen@design-spec.pdf- Attach a PDF design specification and ask the agent to implement features based on itcopilotthen@technical-docs.pdf- Reference a technical documentation PDF when writing code that needs to follow specific standardscopilot -p "Analyze this architecture diagram" @architecture.pdf- Use non-interactive mode to analyze PDF content directlycopilotthen@requirements.pdf @existing-code.ts- Combine PDF requirements with code files for better contextcopilot --resume <session-id>- Resume a session and reference related PDF files for continued work
Additional context
Why this matters:
- The underlying Claude/GPT models already support PDF analysis (multimodal capabilities)
- Users report having to manually copy-paste PDF content as a workaround
- This is a UX/interface limitation, not a model capability limitation
Similar functionality exists in:
- Other AI assistant CLIs
Expected behavior:
- Users should be able to attach PDF files using
@filename.pdfsyntax - PDFs should be processed by the model for analysis and reference
- Multiple PDFs should be supportable in a single session
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by reviewing how the CLI handles @filename references across interactive prompts, -p non-interactive mode, and --resume sessions. Trace the existing file-attachment and model-input flow, then verify that single and multiple PDFs can be referenced, analyzed, combined with code files, and used after resuming a session.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- shell
- Domain
- ai, cli
- Issue type
- Feature
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 45/100