austenstone/GitHub Copilot CLI

GitHub Copilot CLI wrapper

View on GitHub

Trust Signals

Scorecard Score
not yet scored
Maintenance Recency
Activelast commit Jun 22, 2026
License
None

Pinned Snippet

workflow.ymlSHA-pinned
uses: austenstone/copilot-cli@122f2d1522fdec4497d11fe57965ac0112db87e3 # v3.2

tags can be moved; commit SHAs can't. why a SHA?

namedescriptionrequireddefault
copilot-token(Deprecated) The default github.token now supports copilot-requests permission — no PAT needed. Only provide this if you need to override with a specific token.no${{ github.token }}
repo-tokenToken for repository operations (gh CLI). Defaults to github.token. Use a PAT if the agent needs elevated repo permissions.no${{ github.token }}
promptPrompt to send to GitHub Copilotyes
mcp-configMCP configuration for GitHub Copilot [Link](https://docs.github.com/en/copilot/how-tos/use-copilot-agents/coding-agent/extend-coding-agent-with-mcp#writing-a-json-configuration-for-mcp-servers)no
copilot-configConfiguration for GitHub Copilotno{ "banner": "never", "renderMarkdown": true, "theme": "auto", "trustedFolders": [] }
autopilotEnable autopilot continuation in prompt modenotrue
max-turnsMaximum number of autopilot continuation turns (CLI default: 5 when unset)no
no-ask-userDisable the ask_user tool so the agent works autonomously without asking questionsnotrue
silentOutput only the agent response without usage statisticsnofalse
allow-all-toolsAllow all tools without approvalnotrue
allowed-toolsComma-separated list of tools to allow (e.g., "shell(rm),shell(git push)")no
denied-toolsComma-separated list of tools to deny (e.g., "shell(rm),shell(git push)")no
allowed-urlsComma-separated list of URLs or domains to allow (e.g., "github.com,*.api.com")no
denied-urlsComma-separated list of URLs or domains to deny (e.g., "evil.com")no
copilot-versionVersion of Copilot CLI to install (e.g., "latest", "prerelease", "1.0.63")noprerelease
modelModel to use (e.g., "claude-sonnet-4.6", "claude-opus-4.8", "gpt-5.5")no
additional-directoriesComma-separated list of additional directories to trust for file access (e.g., "/tmp,/var/log")no
disable-mcp-serversComma-separated list of MCP servers to disable (e.g., "github-mcp-server,custom-server")no
disable-builtin-mcpsDisable all built-in MCP servers (currently only github-mcp-server)nofalse
enable-all-github-mcp-toolsEnable all GitHub MCP toolsnofalse
add-github-mcp-toolsComma-separated list of specific GitHub MCP tools to enable (e.g., "create_issue,search_code")no
add-github-mcp-toolsetsComma-separated list of GitHub MCP toolsets to enable (e.g., "issues,pull_requests")no
resume-sessionResume from a previous session ID (use "latest" for most recent)no
upload-artifactUpload artifact after running Copilotnotrue
agentSpecify a custom agent to useno
reasoning-effortSet the reasoning effort level (choices: "none", "low", "medium", "high", "xhigh", "max")no
output-formatOutput format (e.g., "json" for JSONL output in prompt mode)no
experimentalEnable experimental featuresnofalse
shareShare session to a markdown file after completion (provide a file path, or "true" for default)no
share-gistShare session to a secret GitHub gist after completionnofalse
fail-on-errorFail the step if the Copilot CLI exits with a non-zero exit codenofalse
log-levelSet the log level (choices: "none", "error", "warning", "info", "debug", "all", "default")noall
optionsAdditional options to pass to the Copilot CLI (e.g., "--no-custom-instructions --model gpt-5")no--screen-reader --no-color --stream off
secret-env-varsComma-separated list of environment variable names whose values will be redacted from output and logs (e.g., "MY_SECRET,API_KEY")no
allow-all-urlsAllow all URLs/network access without approvalnofalse
allow-all-pathsAllow access to all file paths without approval. When false (default), the agent is scoped to $GITHUB_WORKSPACE instead of the entire filesystem.nofalse
contextContext window mode (choices: "default", "long_context")no
attachmentsComma-separated list of file paths to attach to the prompt (e.g., "./diagram.png,./notes.txt")no
available-toolsComma-separated list of tools to make available (allowlist)no
excluded-toolsComma-separated list of tools to excludeno
enable-memoryEnable the agent memory featurenofalse
additional-mcp-configComma-separated list of additional MCP configurations; each item is a JSON string or an @file path (e.g., "@mcp.json")no
modeRun mode (choices: "interactive", "plan", "autopilot")no
session-idUse a specific session IDno
nameName for the sessionno
disallow-temp-dirDisallow the agent from using the system temp directorynofalse
plugin-dirComma-separated list of plugin directories to loadno
namedescription
logs-pathPath to the copilot logs directory
exit-codeExit code from the Copilot CLI command
session-pathPath to the shared session markdown file (if share was used)