Skip to content

Commit 85bbcd0

Browse files
committed
chore: update docs
1 parent 17c819c commit 85bbcd0

File tree

2 files changed

+24
-21
lines changed

2 files changed

+24
-21
lines changed

README.md

Lines changed: 22 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -21,6 +21,7 @@ CodeQL Agent CLI is a tool that automates the process of using CodeQL, a semanti
2121
- Automated CodeQL from detect language, create database and scan.
2222
- Scan remote target (e.g. GitHub repository) or local target (e.g. source code folder).
2323
- Support running on Docker which prepackaged and precompiled CodeQL for running code scanning (*under development*).
24+
- Send results to Discord webhook.
2425

2526
## Requirements
2627

@@ -69,30 +70,32 @@ Usage: codeql-agent scan [options] <target>
6970
scan a source code folder or remote repository (e.g. GitHub repository)
7071

7172
Arguments:
72-
target source code folder or remote repository.
73-
73+
target source code folder or remote repository.
74+
7475
Examples:
75-
codeql-agent src/sammple
76+
codeql-agent scan src/sammple
7677
codeql-agent scan src/sammple --use-docker
7778
codeql-agent scan https://github.com/OWASP/NodeGoat
7879

7980
Options:
80-
-l, --language <language> language of source code. Supported languages: go, java, cpp, csharp, cpp, javascript, ruby. Omitting this option to auto-detect the language.
81-
-o, --output <output> output folder. Default: <target>-codeql-results
82-
-c, --command <command> command to create database for compiled languages, omit if the only languages requested are Python and JavaScript. This specifies the build commands
83-
needed to invoke the compiler. If you don't set this variable, CodeQL will attempt to detect the build system automatically, using a built-in autobuilder
84-
-t, --threads <number> number of threads to use. Pass 0 to use one threads per core on the machine. Default: 1 (default: 1)
85-
--query <query> CodeQL query to run. Default: <language>-security-extended.qls
86-
--format <format> output format. Default: sarif-latest (default: "sarif-latest")
87-
--overwrite overwrite existing database.
88-
--no-download do not download missing queries before analyzing.
89-
--remove-remote-repository remove the remote repository after cloning.
90-
--db-output <dbOutput> database folder path.
91-
--remove-database remove the CodeQL database after scanning.
92-
--create-db-only only create CodeQL database, do not scan.
93-
--use-docker use docker to isolated run CodeQL.
94-
-v, --verbose verbose output
95-
-h, --help display help for command
81+
-l, --language <language> language of source code. Supported languages: go, java, cpp, csharp, cpp, javascript, ruby. Omitting this option to auto-detect the language.
82+
-o, --output <output> output folder. Default: <target>-codeql-results
83+
-c, --command <command> command to create database for compiled languages, omit if the only languages requested are Python and JavaScript. This specifies the build commands needed to invoke the compiler. If
84+
you don't set this variable, CodeQL will attempt to detect the build system automatically, using a built-in autobuilder
85+
-t, --threads <number> number of threads to use. Pass 0 to use one threads per core on the machine. Default: 1 (default: 1)
86+
--query <query> CodeQL query to run. Default: <language>-security-extended.qls
87+
--format <format> output format. Default: sarif-latest (default: "sarif-latest")
88+
--overwrite overwrite existing database.
89+
--download download missing queries before analyzing.
90+
--remove-remote-repository remove the remote repository after cloning.
91+
--db-output <dbOutput> database folder path.
92+
--remove-database remove the CodeQL database after scanning.
93+
--create-db-only only create CodeQL database, do not scan.
94+
--enable-file-logging enable file logging.
95+
--discord-webhook <webhookUrl> discord web hook to send the result to.
96+
--use-docker use docker to isolated run CodeQL.
97+
-v, --verbose verbose output
98+
-h, --help display help for command
9699
```
97100

98101
## Using CodeQL Agent on VSCode

package.json

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "codeql-agent",
3-
"version": "0.1.3",
3+
"version": "0.2.0",
44
"description": "A CodeQL tool to automatically execute code scanning.",
55
"main": "index.js",
66
"scripts": {
@@ -47,4 +47,4 @@
4747
"ts-node": "^10.9.1",
4848
"typescript": "^4.9.4"
4949
}
50-
}
50+
}

0 commit comments

Comments
 (0)