# args-cli
Command-line client for [args](https://args.io). Sign in to args from your terminal so `git push` to args repositories just works.
The binary is named `args`.
> **Status: early.** Only authentication commands ship today. Repository management, code review, and CI features will land in subsequent releases.
## Install
```sh
cargo install args-cli
```
This installs the `args` binary into your Cargo bin directory (usually `~/.cargo/bin`).
## Commands
### `args login`
Authenticates with args via the OAuth device-code flow. Opens a verification URL and waits for you to enter a one-time code in your browser.
```sh
$ args login
Open the following URL in your browser:
https://args.io/oauth/device
Enter the code: ABCD-1234
Successfully logged in as mikkel!
```
On success:
- Your username and email are written to `~/.config/args/config.toml`.
- An access token is stored via `git credential approve`, so `git push` to args repositories authenticates automatically against whatever credential helper your system uses (macOS Keychain, libsecret, Windows Credential Manager, etc.).
### `args status`
Prints the currently logged-in user, or "Not logged in" if no session is active.
```sh
$ args status
Logged in as mikkel
```
## License
Licensed under the [Apache License, Version 2.0](https://www.apache.org/licenses/LICENSE-2.0). Copyright © args contributors.