{"name":"--file","slug":"file","family":"cli","title":"CLI flags","noun":"CLI flag","description":"Flags that take values no longer swallow or drop their arguments, and `--` is handled.","description_source":"entry","described_by":{"version":"2.1.239","anchor":"command-line-flag-parsing-rewritten-around-an-explicit-table"},"presence":{"first_seen":"2.1.138","removed_in":null,"in_current_build":true,"newest_mined":"2.1.308","builds":149,"mined_builds":149,"first_cited":{"version":"2.1.257","released_at":"2026-09-01 17:15:33","spans":1}},"aliases":[],"entries":[{"version":"2.1.290","anchor":"claude-plugin-test-rollout-flag-hold-and-file-form","heading":"claude plugin test now waits for its rollout setting to be saved","line":"`claude plugin test` now waits until a rollout setting is saved for test files to read, and reports when that fails","released_at":"2026-10-05 18:12:44","reason":"found in this entry's text, named in this entry"},{"version":"2.1.280","anchor":"claude-plugin-test-refusal-messaging-refactored-into-a-share","heading":"claude plugin test refusal messaging refactored into a shared helper","line":"The claude plugin test command's refusal messaging was refactored into a shared helper function","released_at":"2026-09-22 15:44:39","reason":"found in this entry's text"},{"version":"2.1.271","anchor":"new-claude-plugin-test-cli-command-for-function-hooks-plug","heading":"New claude plugin test CLI command for function-hooks plugins","line":"New `claude plugin test` command runs a plugin's hook tests in a sandboxed environment that mimics the real runtime","released_at":"2026-09-14 19:45:19","reason":"found in this entry's text"},{"version":"2.1.259","anchor":"new-deny-checked-commands-greprgdiffgitcpmv-and-generi","heading":"New deny-checked commands: grep\/rg\/diff\/git\/cp\/mv and generic argument-path extraction","line":"Path deny rules now extract file arguments from more flag shapes and apply to grep, rg, diff, git, cp and mv.","released_at":"2026-09-02 21:21:42","reason":"found in this entry's text"},{"version":"2.1.257","anchor":"sandboxed-grepawk-argument-allowlisting","heading":"Sandboxed grep\/awk argument allowlisting","line":"New parsers pull file-path operands out of grep and awk arguments so they can be allowlisted for the sandbox.","released_at":"2026-09-01 17:15:33","reason":"found in this entry's text"},{"version":"2.1.239","anchor":"command-line-flag-parsing-rewritten-around-an-explicit-table","heading":"Command-line flag parsing rewritten around an explicit table of value-taking flags","line":"Flags that take values no longer swallow or drop their arguments, and `--` is handled.","released_at":"2026-08-21 17:18:54","reason":"found in this entry's text"},{"version":"2.1.196","anchor":"awk-command-security-analysis","heading":"awk Command Security Analysis","line":null,"released_at":"2026-06-29 20:08:58","reason":"found in this entry's text"}],"entries_total":7,"docs":[{"source":"api","path":"agents-and-tools\/agent-skills\/quickstart","title":"quickstart","documented":false},{"source":"api","path":"agents-and-tools\/tool-use\/code-execution-tool","title":"code-execution-tool","documented":false},{"source":"api","path":"build-with-claude\/files","title":"files","documented":false},{"source":"api","path":"build-with-claude\/pdf-support","title":"pdf-support","documented":false},{"source":"api","path":"build-with-claude\/skills-guide","title":"skills-guide","documented":false},{"source":"api","path":"build-with-claude\/vision","title":"vision","documented":false},{"source":"api","path":"cli-sdks-libraries\/cli\/using","title":"using","documented":false},{"source":"api","path":"manage-claude\/plugins-api","title":"plugins-api","documented":false},{"source":"api","path":"managed-agents\/define-outcomes","title":"DCF Model Rubric","documented":false},{"source":"api","path":"managed-agents\/files","title":"files","documented":false}],"docs_total":11,"gates":[],"related":[],"url":"https:\/\/changelogs.core-directive.com\/reference\/cli\/file","family_url":"https:\/\/changelogs.core-directive.com\/reference\/cli.json"}