Pages in Reference

noust gitlab

GitLab connections: a project and branch picker, and private clones.

Reference Updated 29 October 2026 View as Markdown

Shell

noust gitlab [OPTIONS] COMMAND [ARGS]...

Subcommands: branches, connect, groups, list, oauth-app, projects, remove, test

noust gitlab branches

List a project's branches (PROJECT is its id or its path, group/project).

Shell

noust gitlab branches [OPTIONS] NAME PROJECT

Arguments: name, project

Option	What it does	Default
`--json`	Print the branches as JSON.
`--reason`	Why this change is made (a change reference, a ticket). Recorded with the command in the audit log; required only where a compliance framework asks for it (ENS) or security.change_reasons is on.

noust gitlab connect

Add a connection that signs in with an access token.

Shell

noust gitlab connect [OPTIONS] NAME

Arguments: name

Option	What it does	Default
`--host`	The GitLab host: gitlab.com or git.example.com.
`--token-stdin`	Read the access token from standard input (else NOUST_GITLAB_TOKEN).
`--json`	Print the connection as JSON.
`--reason`	Why this change is made (a change reference, a ticket). Recorded with the command in the audit log; required only where a compliance framework asks for it (ENS) or security.change_reasons is on.

noust gitlab groups

List the groups a connection's user belongs to.

Shell

noust gitlab groups [OPTIONS] NAME

Arguments: name

Option	What it does	Default
`--json`	Print the groups as JSON.
`--reason`	Why this change is made (a change reference, a ticket). Recorded with the command in the audit log; required only where a compliance framework asks for it (ENS) or security.change_reasons is on.

noust gitlab list

List the GitLab connections and OAuth applications.

Shell

noust gitlab list [OPTIONS]

Option	What it does	Default
`--json`	Print the connections as JSON.
`--reason`	Why this change is made (a change reference, a ticket). Recorded with the command in the audit log; required only where a compliance framework asks for it (ENS) or security.change_reasons is on.

noust gitlab oauth-app

The OAuth application registered in GitLab, so people can connect without a token.

Shell

noust gitlab oauth-app [OPTIONS] COMMAND [ARGS]...

Subcommands: remove, set

noust gitlab oauth-app remove

Forget the OAuth application of a host.

Shell

noust gitlab oauth-app remove [OPTIONS]

Option	What it does	Default
`--host`
`--reason`	Why this change is made (a change reference, a ticket). Recorded with the command in the audit log; required only where a compliance framework asks for it (ENS) or security.change_reasons is on.

noust gitlab oauth-app set

Record an OAuth application.

Shell

noust gitlab oauth-app set [OPTIONS]

Option	What it does	Default
`--host`	The GitLab host it is registered on.
`--client-id`	The application's id.
`--client-secret-stdin`	Read the application's secret from standard input (else NOUST_GITLAB_CLIENT_SECRET).
`--reason`	Why this change is made (a change reference, a ticket). Recorded with the command in the audit log; required only where a compliance framework asks for it (ENS) or security.change_reasons is on.

noust gitlab projects

List the projects a connection's user can read, most recently active first.

Shell

noust gitlab projects [OPTIONS] NAME

Arguments: name

Option	What it does	Default
`--group`	Only the projects of this group (its full path) and subgroups.
`--search`	Only projects whose name contains this.
`--limit`		`200`
`--json`	Print the projects as JSON.
`--reason`	Why this change is made (a change reference, a ticket). Recorded with the command in the audit log; required only where a compliance framework asks for it (ENS) or security.change_reasons is on.

noust gitlab remove

Forget a connection and its token.

Shell

noust gitlab remove [OPTIONS] NAME

Arguments: name

Option	What it does	Default
`--reason`	Why this change is made (a change reference, a ticket). Recorded with the command in the audit log; required only where a compliance framework asks for it (ENS) or security.change_reasons is on.

noust gitlab test

Ask GitLab who a connection is, and record whether it still works.

Shell

noust gitlab test [OPTIONS] NAME

Arguments: name

Option	What it does	Default
`--json`	Print the connection as JSON.
`--reason`	Why this change is made (a change reference, a ticket). Recorded with the command in the audit log; required only where a compliance framework asks for it (ENS) or security.change_reasons is on.

Something on this page is wrong or unclear? Report it on GitHub.

Help, contributing and the project’s policies are under Project.