schools-cli
v1.1.2
Published
Schools Center CLI — school operations for coding agents. Students, fees, attendance, exams, reports. As easy as git.
Maintainers
Readme
sc
School operations for coding agents. Students, fees, attendance, exams, reports — as easy as git.
Install
npm install -g schools-cliQuick Start
# Authenticate
sc login --email [email protected] --password xxx --local
# School overview
sc dashboard
# List students
sc students --class "Grade 10"
# Mark attendance
sc attendance mark --class ID --section ID --date 2026-06-10 --data '[{"studentId":"...","status":"present"}]'
# Collect a fee
sc fees collect --student ID --amount 5000
# View exam results
sc exam results EXAM_ID
# Generate a report
sc report fee-collection --from 2026-01-01 --to 2026-06-30
# Full reference
sc --helpFeatures
- Students — list, create, update, delete, export, promote, bulk status, timeline
- Attendance — mark, view, reports (day/month/class), subject attendance, leave management
- Exams — schedule, marks entry, results, marksheets, grades, online exams, certificates
- Fees — types, groups, due, collect, discounts, offline payments, carry forward, reports
- Staff & HR — list, create, departments, designations, leave, payroll, staff attendance
- Reports — 30+ types: financial overview, fee defaulters, attendance summaries, exam results
- Library — books, issue, return, members
- Transport — vehicles, routes, student assignment
- Hostel — rooms, types, allocation
- Communication — notifications, email/SMS templates, logs, notice board
- Front Office — visitors, enquiries, complaints, postal, phone calls
- Facility — work orders, assets, maintenance, room bookings, inventory
- Calendar — events, holidays
- Lesson Plans — syllabus, topics, lesson plans
- CMS — pages, menus, media
- Finance — income, expense, heads, reports
- Settings — sessions, roles, modules, currencies, languages
- Portals — teacher, student, parent, superadmin views
- Alumni — directory, events
Per-Project Config
sc login --local --email [email protected] --password xxx # saves to .sc/config.json (project-local)
sc login --email [email protected] --password xxx # saves to ~/.sc/config.json (global)
sc config # show which config is activeLocal config overrides global. Add .sc/ to your .gitignore.
Agent Integration
Add to your CLAUDE.md, .cursorrules, .clinerules, or .windsurfrules:
## Schools Center
Use the sc CLI for school operations. Token is in .sc/config.json (auto-loaded).
### Session start (DO THIS FIRST)
sc dashboard # school overview
sc students --class "Grade 10" # check enrollment
### Commands
sc students # list students
sc attendance mark # mark attendance
sc fees due # check fee dues
sc report financial-overview # financial summary
sc --help # full referenceMCP Integration (Claude Code)
Add to .mcp.json in your project root:
{
"mcpServers": {
"schools": {
"type": "stdio",
"command": "sc",
"args": ["mcp-serve"]
}
}
}This gives Claude Code native access to 16 school management tools.
Documentation
License
Proprietary — Tyga.Cloud Ltd. See LICENSE.
