dimicheck-tui 0.1.0

DimiCheck terminal dashboard

DimiCheck TUI

DimiCheck TUI is a terminal dashboard for DimiCheck students. It uses the public OAuth PKCE flow and calls only the student app API surface for v1.

Install

Use pipx for the public install path:

pipx install dimicheck-tui
dimicheck

For local development from this checkout:

cd packages/dimicheck-tui
uv run dimicheck --help
uv run dimicheck

Set DIMICHECK_BASE_URL when testing against a local or staging server:

cd packages/dimicheck-tui
DIMICHECK_BASE_URL=http://127.0.0.1:5000 uv run dimicheck

Authentication

The TUI never asks for a password in the terminal. On first launch it opens the browser, signs in through DimiCheck OAuth, and stores tokens through the OS credential store.

• macOS: Keychain
• Windows: Credential Manager
• Linux: Secret Service compatible keyring

If the OS keyring is unavailable, the app fails closed by default. For controlled environments you can explicitly allow a local token file:

dimicheck --allow-plaintext-token

That fallback writes a 0600 permission file. Do not use it on shared machines.

Commands

dimicheck                 # open the TUI dashboard
dimicheck login           # browser OAuth login
dimicheck logout          # revoke refresh token and delete local tokens
dimicheck status get      # print current status
dimicheck status set toilet
dimicheck status set etc --reason "상담"
dimicheck schoollife      # print today's timetable and meal

TUI shortcuts:

• S: change status
• R: refresh dashboard
• L: logout
• Q: quit

v1 Scope

The public v1 supports:

• current student status read/write
• today's schoollife summary
• OAuth PKCE login/logout

It intentionally does not expose routine editing, teacher/admin tools, browser session cookies, remember tokens, or /api/mcp/state.

Server Notes

The server seeds a dedicated public OAuth client:

• client id: dimicheck-tui-public
• redirect URI ports: 45831 through 45835
• scopes: openid basic student_info status.read status.write

Server deployments should happen from the repository root. This package is intentionally separate so the public TUI release does not include Flask, database, or Google Sheets dependencies.