shaon

shaon

shaon is a Rust CLI, MCP server, and agent skill for personal attendance, payslip, salary, and related self-service tasks on your own Hilan account.

Features

• One tool, three surfaces: use shaon as a CLI, an MCP server (shaon serve), or an agent skill for Claude Code / Codex-compatible workflows.
• Safety-first writes: attendance writes preview by default and require explicit --execute for live submission.
• Payslips and salary: download or open password-protected payslips and fetch recent salary history.
• Agent-friendly JSON: status, overview, errors, reports, and payroll commands return stable structured output.
• Release-ready distribution: GitHub Releases publish checksummed binaries; Homebrew and Scoop are updated from the release workflow.

Responsibility and Scope

You are responsible for all attendance submissions, payslip downloads, and credential handling performed with this tool. Use is conditional on your compliance with your employer's policies and your Hilanet customer's terms of service. shaon is intended for automating your own single-user account; multi-user, aggregation, and third-party-data use are out of scope.

shaon is an independent open-source project. It is not endorsed by, affiliated with, or sponsored by Hilan Ltd. Hilan and Hilanet are names and marks of their respective owner, used solely to identify compatibility and the target system. No trademark license is granted, and no claim of sponsorship, endorsement, or affiliation is made.

shaon is not payroll, tax, HR, legal, or employment-compliance advice. The software is provided "AS IS" under the MIT License, without warranty of any kind.

Installation

Homebrew (macOS / Linux)

brew install avivsinai/tap/shaon

Scoop (Windows)

Windows bucket installs start with the first release produced by the PR-based release workflow in this repo. If the current latest release predates Windows packaging, wait for the next tagged release or build from source.

scoop bucket add avivsinai https://github.com/avivsinai/scoop-bucket
scoop install shaon

Install Script

curl -fsSL https://raw.githubusercontent.com/avivsinai/shaon/main/scripts/install.sh | bash

Pin a specific release if needed:

curl -fsSL https://raw.githubusercontent.com/avivsinai/shaon/main/scripts/install.sh | VERSION=v0.8.2 bash

Cargo

cargo install --git https://github.com/avivsinai/shaon shaon

Prebuilt Binaries

Download a release asset from GitHub Releases and place the extracted shaon binary on your PATH.

# macOS (Apple Silicon)
curl -LO https://github.com/avivsinai/shaon/releases/latest/download/shaon-aarch64-apple-darwin.tar.gz
tar xzf shaon-aarch64-apple-darwin.tar.gz

# macOS (Intel)
curl -LO https://github.com/avivsinai/shaon/releases/latest/download/shaon-x86_64-apple-darwin.tar.gz
tar xzf shaon-x86_64-apple-darwin.tar.gz

# Linux (x86_64)
curl -LO https://github.com/avivsinai/shaon/releases/latest/download/shaon-x86_64-unknown-linux-gnu.tar.gz
tar xzf shaon-x86_64-unknown-linux-gnu.tar.gz

If you are working from a repo checkout, prefer:

scripts/run.sh <command> [args]

On macOS, scripts/run.sh signs the local build with the same stable identifier-based designated requirement used by release artifacts. If you previously approved an older local build in Keychain, macOS may ask for "Always Allow" once after upgrading to this signing model.

Agent Skill

Install the shaon skill for Claude Code or repo-native skill managers:

npx skills add avivsinai/shaon -g -y

/plugin marketplace add avivsinai/skills-marketplace
/plugin install shaon@avivsinai-marketplace