tldr/pages/common/ag.md

# ag

> The Silver Searcher. Like ack, but aims to be faster.
> More information: <https://github.com/ggreer/the_silver_searcher>.

- Find files containing "foo", and print the line matches in context:

`ag {{foo}}`

- Find files containing "foo" in a specific directory:

`ag {{foo}} {{path/to/directory}}`

- Find files containing "foo", but only list the filenames:

`ag -l {{foo}}`

- Find files containing "FOO" case-insensitively, and print only the match, rather than the whole line:

`ag -i -o {{FOO}}`

- Find "foo" in files with a name matching "bar":

`ag {{foo}} -G {{bar}}`

- Find files whose contents match a regular expression:

`ag '{{^ba(r|z)$}}'`

- Find files with a name matching "foo":

`ag -g {{foo}}`
Add ag (the_silver_searcher) page 2014-05-02 02:23:01 +01:00			`# ag`

multiple pages: rephrase without adjectives (#3846) Co-authored-by: Starbeamrainbowlabs <sbrl@starbeamrainbowlabs.com> Co-authored-by: Zlatan Vasović <zlatanvasovic@gmail.com> 2020-02-11 17:53:43 +00:00			`> The Silver Searcher. Like ack, but aims to be faster.`
ag: add link to homepage 2019-06-09 00:05:26 +01:00			`> More information: <https://github.com/ggreer/the_silver_searcher>.`
Add ag (the_silver_searcher) page 2014-05-02 02:23:01 +01:00
ag: add -l and -o options 2016-05-02 14:33:59 +01:00			`- Find files containing "foo", and print the line matches in context:`
Add ag (the_silver_searcher) page 2014-05-02 02:23:01 +01:00
ag: tokenize values 2017-10-30 22:48:56 +00:00			`ag {{foo}}`
Add ag (the_silver_searcher) page 2014-05-02 02:23:01 +01:00
ag: move text to make it the 2nd example (#2498) 2018-10-26 20:29:29 +01:00			`- Find files containing "foo" in a specific directory:`

Refactor: improve consistency of the term "directory". This commit changes the term "folder" to "directory" in every instance where the first is used in an example description, but the second is used in the example code, and vice versa. 2019-02-08 00:28:43 +00:00			`ag {{foo}} {{path/to/directory}}`
ag: move text to make it the 2nd example (#2498) 2018-10-26 20:29:29 +01:00
ag: add -l and -o options 2016-05-02 14:33:59 +01:00			`- Find files containing "foo", but only list the filenames:`
Update ag 1. Add case-insensitive search example 2016-02-18 17:58:34 +00:00
ag: tokenize values 2017-10-30 22:48:56 +00:00			`ag -l {{foo}}`
ag: add -l and -o options 2016-05-02 14:33:59 +01:00
			`- Find files containing "FOO" case-insensitively, and print only the match, rather than the whole line:`

ag: tokenize values 2017-10-30 22:48:56 +00:00			`ag -i -o {{FOO}}`
Update ag 1. Add case-insensitive search example 2016-02-18 17:58:34 +00:00
Formatted all pages according to guidelines. 2016-01-07 17:31:27 +00:00			`- Find "foo" in files with a name matching "bar":`
Add ag (the_silver_searcher) page 2014-05-02 02:23:01 +01:00
ag: tokenize values 2017-10-30 22:48:56 +00:00			`ag {{foo}} -G {{bar}}`
Add ag (the_silver_searcher) page 2014-05-02 02:23:01 +01:00
			`- Find files whose contents match a regular expression:`

Fix tokenization 2017-10-31 21:41:52 +00:00			`ag '{{^ba(r\|z)$}}'`
Add ag (the_silver_searcher) page 2014-05-02 02:23:01 +01:00
Formatted all pages according to guidelines. 2016-01-07 17:31:27 +00:00			`- Find files with a name matching "foo":`
Add ag (the_silver_searcher) page 2014-05-02 02:23:01 +01:00
ag: tokenize values 2017-10-30 22:48:56 +00:00			`ag -g {{foo}}`