Power your agent
Install from the publisher. Not a PlugMCP endpoint.
Host a copy with our keys and logs.
No packaged release in the registry yet. Follow the repository README.
Remote URL or a command on your machine? How the two installs differ
Run on PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
Launchshaon is a Rust CLI, MCP server, and agent skill for personal attendance, payslip, salary, and related self-service tasks on your own Hilan account.
shaon as a CLI, an MCP server (shaon serve), or an agent skill for Claude Code / Codex-compatible workflows.--execute for live submission.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.
brew install avivsinai/tap/shaon
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
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 install --git https://github.com/avivsinai/shaon shaon
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 ad-hoc with the stable
identifier io.github.avivsinai.shaon and an identifier-based designated
requirement. Release artifacts use the same identifier and are signed with a
Developer ID and notarized when the release signing secrets are configured,
otherwise ad-hoc as for local builds. If you previously approved a build with
a different signature in Keychain, macOS may ask for "Always Allow" once.
Install the shaon skill for Claude Code or repo-native skill managers:
npx skills add avivsinai/shaon -g -y
Known issue: Claude Code marketplace installs currently clone over SSH, which can prompt for SSH keys unexpectedly. See anthropics/claude-code#14485. If that affects your setup, prefer
skills.sh.
/plugin marketplace add avivsinai/skills-marketplace
/plugin install shaon@avivsinai-marketplace
git clone https://github.com/avivsinai/shaon.git
cp -r shaon/.claude/skills/shaon ~/.claude/skills/
Codex CLI does not currently support marketplace indirection. Use the repo-native skill layout or skills.sh.
Create ~/.shaon/config.toml:
subdomain = "mycompany"
username = "123456789"
# optional
payslip_folder = "/Users/you/Downloads/payslips"
payslip_format = "%Y-%m.pdf"
Authenticate once:
shaon auth
If stored credentials are stale and you want a deterministic refresh prompt:
shaon auth --force-prompt
If Hilan presents a CAPTCHA, solve it in the browser and rerun the command.
shaon attendance overview --month 2026-04
shaon attendance status --month 2026-04
shaon attendance errors --month 2026-04
shaon reports sheet
shaon reports corrections
shaon payroll salary --months 6
JSON contract notes for agents:
shaon attendance status --json returns { month, employee_id, days[] } with day_name, entry_time, exit_time, attendance_type, total_hours, has_error, error_message, and source.shaon attendance overview --json returns missing_days as { date, day_name } objects rather than bare strings.suggested_actions is a tagged union keyed by kind; action fields live at the top level rather than inside a generic params bag.shaon attendance overview --json --detailed adds a top-level days[] array using the same schema as attendance status --json.# Preview first
shaon attendance report day 2026-04-09 --type "regular" --hours 09:00-18:00
shaon attendance resolve 2026-04-09 --type "regular" --hours 09:00-18:00
shaon attendance auto-fill --month 2026-04 --type "work from home" --hours 09:00-18:00
# Then execute when the preview looks right
shaon attendance report day 2026-04-09 --type "regular" --hours 09:00-18:00 --execute
shaon attendance resolve 2026-04-09 --type "regular" --hours 09:00-18:00 --execute
shaon attendance auto-fill --month 2026-04 --type "work from home" --hours 09:00-18:00 --execute
shaon payroll payslip download --month 2026-03
shaon payroll payslip view --month 2026-03
shaon payroll payslip password --force-sensitive-output prints the current Hilan account password in plaintext to standard output. It does not recover historical passwords used for PDFs encrypted before a password change. Run it only on a private interactive terminal you control.
For the exact live surface, use:
shaon --help
shaon <command> --help
Start the server with:
shaon serve
Example MCP config with an installed binary:
{
"mcpServers": {
"shaon": {
"command": "shaon",
"args": ["serve"]
}
}
}
From a repo checkout, use scripts/run.sh serve instead of shaon serve.
--execute in the CLI, or execute: true over MCP, only after reviewing the preview and explicitly deciding to submit it.attendance auto-fill stay capped unless you raise the limit explicitly.After downloading a release binary, verify its checksum:
curl -LO https://github.com/avivsinai/shaon/releases/latest/download/SHA256SUMS.txt
# macOS
shasum -a 256 -c SHA256SUMS.txt --ignore-missing
# Linux
sha256sum -c SHA256SUMS.txt --ignore-missing
Rust CLI, MCP server, and Claude Code plugin for personal attendance, payslips, salary, and related self-service tasks on your own Hilan account.
Tools
No tool list yet. Remote servers get one after the first health check.
FAQ
Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.
No required environment variable is listed on this record.
Shaon runs locally over stdio.
Last checked 2026-10-28. Rust CLI, MCP server, and Claude Code plugin for personal attendance, payslips, salary, and related self-service tasks on your own Hilan account.