cli-anything-jumpserver
Stateful CLI harness for JumpServer bastion host management. Supports asset, user, permission, account, session, audit, and operations management via REST API, with both one-shot and interactive REPL modes.
معلومات المصدر
- المستودع
- HKUDS/CLI-Anything
- آخر نشاط في المصدر
- ١١ يونيو ٢٠٢٦ في ١١:٢٦
- لغة SKILL.md المكتشفة
- الإنجليزية
- النجوم
- ٥٠٬٧٤٩
- التفرعات
- ٤٬٦٣٩
خيارات التثبيت
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
مراجعة ملفات المصدر
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
عرض SKILL.md
SKILL.md
تعليمات المصدر · معاينة للقراءة فقط- name
- cli-anything-jumpserver
- description
- Stateful CLI harness for JumpServer bastion host management. Supports asset, user, permission, account, session, audit, and operations management via REST API, with both one-shot and interactive REPL modes.
- version
- 0.1.0
- category
- infrastructure
- tags
- ["jumpserver","bastion","pam","security","ssh","cli"]
- commands
- [{"group":"auth","description":"Authentication and session management","subcommands":["[Truncated]","[Truncated]","[Truncated]","[Truncated]"]},{"group":"asset","description":"Manage assets (hosts, devices, databases, nodes, platforms, gateways, zones)","subcommands":["[Truncated]","[Truncated]","[Truncated]","[Truncated]","[Truncated]","[Truncated]","[Truncated]","[Truncated]","[Truncated]"]},{"group":"user","description":"Manage users and user groups","subcommands":["[Truncated]","[Truncated]","[Truncated]","[Truncated]","[Truncated]","[Truncated]","[Truncated]","[Truncated]","[Truncated]","[Truncated]"]},{"group":"perm","description":"Manage asset permissions","subcommands":["[Truncated]","[Truncated]","[Truncated]","[Truncated]","[Truncated]","[Truncated]","[Truncated]"]},{"group":"account","description":"Manage asset accounts and credentials","subcommands":["[Truncated]","[Truncated]","[Truncated]","[Truncated]","[Truncated]","[Truncated]","[Truncated]"]},{"group":"session","description":"Manage terminal sessions and replays","subcommands":["[Truncated]","[Truncated]","[Truncated]","[Truncated]","[Truncated]","[Truncated]"]},{"group":"audit","description":"View audit logs","subcommands":["[Truncated]","[Truncated]","[Truncated]","[Truncated]","[Truncated]"]},{"group":"ops","description":"Manage operations and job execution","subcommands":["[Truncated]","[Truncated]","[Truncated]","[Truncated]"]},{"group":"system","description":"Manage system settings","subcommands":["[Truncated]","[Truncated]","[Truncated]"]},{"group":"label","description":"Manage labels","subcommands":["[Truncated]"]},{"group":"role","description":"Manage roles and permissions","subcommands":["[Truncated]","[Truncated]"]}]
# cli-anything-jumpserver
Stateful CLI harness for JumpServer bastion host. Manage assets, users, permissions, accounts, sessions, audits, and more via the JumpServer REST API.
## Quick Start
```bash
# Install
cd agent-harness && pip install -e .
# Authenticate
cli-anything-jumpserver auth login --url https://jumpserver.example.com --username admin
# List hosts
cli-anything-jumpserver asset list --type host
# Interactive REPL mode
cli-anything-jumpserver --interactive
```
## Agent Usage Guidance
This CLI is designed for AI agent consumption. Key features for agents:
### JSON Output Mode
All commands support `--output json` for machine-parseable output:
```bash
cli-anything-jumpserver asset list --type host --output json
```
### Dry Run Mode
All mutation commands support `--dry-run` to preview without execution:
```bash
cli-anything-jumpserver asset create --name test --address 10.0.0.1 --platform 1 --dry-run --output json
```
### Environment Variables
- `JUMPSERVER_URL` - Default JumpServer URL
- `JUMPSERVER_USERNAME` - Default username
- `JUMPSERVER_PASSWORD` - Default password
### Typical Agent Workflows
**1. Discovery and Inventory**
```bash
# Check connection
cli-anything-jumpserver auth status --output json
# List all hosts
cli-anything-jumpserver asset list --type host --output json
# Get asset details
cli-anything-jumpserver asset get <ID> --type host --output json
# List all users
cli-anything-jumpserver user list --output json
```
**2. User and Permission Management**
```bash
# Create user
cli-anything-jumpserver user create --name "New User" --username newuser --email user@example.com --output json --dry-run
# Grant asset access
cli-anything-jumpserver perm create --name "App Access" --users "user1,user2" --assets "asset1,asset2" --output json --dry-run
# Verify permissions
cli-anything-jumpserver perm users <PERM_ID> --output json
```
**3. Security Audit**
```bash
# Check failed logins
cli-anything-jumpserver audit login --status failed --output json
# Review operations
cli-anything-jumpserver audit operate --action delete --output json
# Check active sessions
cli-anything-jumpserver session list --active --output json
# View command history
cli-anything-jumpserver session command list --risk 5 --output json
```
**4. Session Management**
```bash
# Monitor active sessions
cli-anything-jumpserver session list --active --output json
# Check terminal health
cli-anything-jumpserver session terminal list --output json
cli-anything-jumpserver session terminal status <TERMINAL_ID> --output json
```
## Output Formats
| Format | Flag | Use Case |
|--------|------|----------|
| Table | `--output table` (default) | Human-readable display |
| JSON | `--output json` | Agent consumption, scripting |
| YAML | `--output yaml` | Configuration, readability |
## Exit Codes
| Code | Meaning |
|------|---------|
| 0 | Success |
| 1 | CLI error (auth, API, etc.) |
| 2 | Usage error (invalid options/arguments) |
| 130 | Interrupted (Ctrl+C) |
## File Locations
| Path | Purpose |
|------|---------|
| `~/.jumpserver-cli/session.json` | Authentication session |
| `~/.jumpserver-cli/state.json` | CLI operational state |
عرض على GitHub