my-cu-cli

CLI app for the My CU platform to check student information directly from the terminal.

Features

• Interactive CLI experience with prompts and menus
• Quick access to GPA and subject-related information
• Works on Windows, macOS, and Linux

Tech Stack

• TypeScript
• Commander (CLI command framework)
• Inquirer (interactive prompts)
• Puppeteer (web automation)

Requirements

• Node.js 20+

Install (Client Usage)

Install globally:

npm install -g my-cu-cli

Run from anywhere:

my-cu info

Update to latest version:

npm update -g my-cu-cli

Local Development

git clone https://github.com/GIORGIPUNK123/my-cu-cli
cd my-cu-cli
npm install
npm run build
npm link
my-cu info

Release Process

1. Apply your code changes and commit.
2. Bump version:

npm version patch

3. Push commit and tags:

git push --follow-tags

This triggers the GitHub Actions release workflow, which:

• Builds on Ubuntu, macOS, and Windows
• Publishes to npm for tags starting with v

Trusted Publishing Setup (Recommended)

Use npm Trusted Publishing with GitHub Actions (OIDC) for secure CI publishing without OTP.

1. In npm package settings, enable Trusted Publishing for this GitHub repository/workflow.
2. Keep the workflow permission id-token: write.
3. No NPM_TOKEN secret is required when Trusted Publishing is configured correctly.

Troubleshooting

If install fails with npm 404, the package version may not be published yet. Check:

npm view my-cu-cli

If publish fails with EOTP in GitHub Actions, Trusted Publishing is not fully configured yet.

• Verify trusted publisher is linked to the same repository and workflow.
• Ensure release runs from tag push in this repository (not from a fork).