Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Add user-level custom agent configuration

Open Beginner friendly
#46,157 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

@ashis-baral is already working on this.

Since Oct 2, 2026.

  • #46158 by @ashis-baral — open

Assessment

Difficulty
1/5
Estimated time
Under an hour
Newbie friendliness
90/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Active
Tech stack
github
Domain
cli, documentation

Research direction

Open the affected GitHub Docs article, especially the “Where you can configure custom agents” section. Add the user level and document the $HOME/.copilot/agents/CUSTOM-AGENT-NAME.md location, then verify the rendered list and wording explain that it applies across repositories.

Written by the indexing model from the issue text.

Description

builder persona content copilot
Code of Conduct
What article on docs.github.com is affected?

https://docs.github.com/en/copilot/concepts/agents/copilot-cli/about-custom-agents#where-you-can-configure-custom-agents

What part(s) of the article would you like to see updated?

The Where you can configure custom agents section currently documents three configuration levels:

  • Repository level

  • Organization level

  • Enterprise level

Add the user level to this list.

For GitHub Copilot CLI, custom agents can also be configured in the user's home directory using:

$HOME/.copilot/agents/CUSTOM-AGENT-NAME.md

This provides user-level instructions that apply across repositories.

Additional information

A user-level agent is useful when a developer wants the same custom agent and instructions to be available across repositories without modifying each repository

Dominant language
TypeScript
Stars
21k
Forks
69k
Avg merge
8h 53m
Merged PRs (30d)
114

Getting set up

Open in Codespaces

Starts the project's dev container in your browser, under your own GitHub account.

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from github/docs

All issues in github/docs

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.