@ait-co/console-cli 0.1.2 โ 0.1.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +22 -22
- package/dist/cli.mjs +831 -412
- package/dist/cli.mjs.map +1 -1
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
# console-cli
|
|
2
2
|
|
|
3
|
-
> ๐ง **
|
|
4
|
-
>
|
|
3
|
+
> ๐ง **Pre-1.0 (`0.1.x`)** โ published to npm but the surface is still small. `whoami` / `login` / `logout` / `upgrade` are usable today; `deploy` / `logs` / `status` are next on [TODO.md](./TODO.md).
|
|
4
|
+
> 1.0 ์ด์ ๋จ๊ณ์
๋๋ค. ์ผ๋ถ ๋ช
๋ น(`whoami`/`login`/`logout`/`upgrade`)๋ง ๋์ํ๊ณ , `deploy`/`logs`/`status`๋ ์งํ ์ค์
๋๋ค.
|
|
5
5
|
|
|
6
|
-
`
|
|
6
|
+
`aitcc` is a community-maintained CLI for automating Apps in Toss developer console operations โ log in once in a browser, then drive subsequent operations from your shell or from an AI coding agent via headless browser automation.
|
|
7
7
|
|
|
8
8
|
์ฑ์ธํ ์ค ์ฝ์์ CLI๋ก ์๋ํํ๋ ์ปค๋ฎค๋ํฐ ๋๊ตฌ. ์ต์ด ๋ก๊ทธ์ธ๋ง ๋ธ๋ผ์ฐ์ ๋ก ํ๊ณ , ์ดํ ์์
์ headless ๋ธ๋ผ์ฐ์ ๋ก ์ฒ๋ฆฌํ๋ค. (MCP ๋ชจ๋๋ ํ์์ โ [TODO.md](./TODO.md) ์ฐธ๊ณ .)
|
|
9
9
|
|
|
@@ -19,15 +19,15 @@
|
|
|
19
19
|
curl -fsSL https://raw.githubusercontent.com/apps-in-toss-community/console-cli/main/install.sh | sh
|
|
20
20
|
```
|
|
21
21
|
|
|
22
|
-
The installer detects OS (`uname -s`) and arch (`uname -m`), downloads the matching binary from the latest GitHub Release, verifies it against `SHA256SUMS`, and installs it to `$HOME/.local/bin/
|
|
22
|
+
The installer detects OS (`uname -s`) and arch (`uname -m`), downloads the matching binary from the latest GitHub Release, verifies it against `SHA256SUMS`, and installs it to `$HOME/.local/bin/aitcc`. Node is **not** required.
|
|
23
23
|
|
|
24
24
|
Pin a specific version:
|
|
25
25
|
|
|
26
26
|
```sh
|
|
27
|
-
curl -fsSL https://raw.githubusercontent.com/apps-in-toss-community/console-cli/main/install.sh |
|
|
27
|
+
curl -fsSL https://raw.githubusercontent.com/apps-in-toss-community/console-cli/main/install.sh | AITCC_VERSION=v0.1.1 sh
|
|
28
28
|
```
|
|
29
29
|
|
|
30
|
-
Override the install directory with `
|
|
30
|
+
Override the install directory with `AITCC_INSTALL_DIR=/custom/path` (default `$HOME/.local/bin`).
|
|
31
31
|
|
|
32
32
|
### npm (fallback)
|
|
33
33
|
|
|
@@ -43,35 +43,35 @@ This is the path that `agent-plugin` uses when a project already has Node instal
|
|
|
43
43
|
## Quick usage
|
|
44
44
|
|
|
45
45
|
```sh
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
46
|
+
aitcc --version # print the embedded version
|
|
47
|
+
aitcc login # launch a browser window, sign in there, and capture the session cookies
|
|
48
|
+
aitcc logout # delete the local session file
|
|
49
|
+
aitcc whoami # show the currently logged-in user live from the console API
|
|
50
|
+
aitcc whoami --offline # use the cached identity without hitting the API
|
|
51
|
+
aitcc whoami --json # machine-readable output for scripts and agents
|
|
52
|
+
aitcc upgrade # self-update to the latest GitHub Release (binary installs only)
|
|
53
|
+
aitcc upgrade --dry-run # check for an update without downloading or replacing
|
|
54
|
+
aitcc upgrade --force # reinstall the latest release even if versions match
|
|
55
55
|
```
|
|
56
56
|
|
|
57
|
-
`
|
|
57
|
+
`aitcc upgrade` respects `GITHUB_TOKEN` to avoid anonymous GitHub API rate limits.
|
|
58
58
|
|
|
59
59
|
Planned commands โ `deploy`, `logs`, `status` โ are tracked in [TODO.md](./TODO.md).
|
|
60
60
|
|
|
61
61
|
### Login details
|
|
62
62
|
|
|
63
|
-
`
|
|
63
|
+
`aitcc login` launches a Chrome-family browser via the Chrome DevTools Protocol, navigates it to the Apps in Toss developer console sign-in URL, and waits for the main frame to reach the post-login workspace page. Once it does, the CLI dumps all cookies over CDP (including `HttpOnly` auth cookies that JavaScript can't see) and persists them to the local session file. The browser runs against a temporary, isolated `--user-data-dir` that is wiped on exit, so your everyday browser profile is never touched.
|
|
64
64
|
|
|
65
|
-
The
|
|
65
|
+
The CLI looks for Chrome in the standard OS install locations (Google Chrome, Chromium, Microsoft Edge). Override the executable with `AITCC_BROWSER=/path/to/chrome` if your install is elsewhere; override the sign-in URL with `AITCC_OAUTH_URL` if you need to point at a staging environment. `--timeout <seconds>` controls how long the CLI will wait for sign-in to finish (default 300s).
|
|
66
66
|
|
|
67
67
|
## Session storage
|
|
68
68
|
|
|
69
69
|
The local session lives at an XDG-compliant path with file mode `0600`:
|
|
70
70
|
|
|
71
|
-
- Linux/macOS: `$XDG_CONFIG_HOME/
|
|
72
|
-
- Windows: `%APPDATA%\
|
|
71
|
+
- Linux/macOS: `$XDG_CONFIG_HOME/aitcc/session.json` (fallback `~/.config/aitcc/session.json`)
|
|
72
|
+
- Windows: `%APPDATA%\aitcc\session.json`
|
|
73
73
|
|
|
74
|
-
The containing directory is created with mode `0700`. Cookies
|
|
74
|
+
The containing directory is created with mode `0700`. Cookies captured during login are **never** printed, logged, or attached to `--verbose` output โ only `user.email`, `name`, and workspace summary surface through `whoami`.
|
|
75
75
|
|
|
76
76
|
See [CLAUDE.md](./CLAUDE.md) for the rationale behind using a plain `0600` file instead of an OS keychain.
|
|
77
77
|
|
|
@@ -87,4 +87,4 @@ Every command accepts `--json`. When set:
|
|
|
87
87
|
|
|
88
88
|
## Status
|
|
89
89
|
|
|
90
|
-
|
|
90
|
+
`login`, `logout`, `whoami`, and `upgrade` are implemented end-to-end โ `login` drives a real browser over CDP and `whoami` reads the live console member API. `deploy`, `logs`, `status` are next โ see [TODO.md](./TODO.md). See the [organization landing page](https://apps-in-toss-community.github.io/) for the full roadmap.
|