{"id":35222174,"url":"https://github.com/robinmordasiewicz/f5xc-xcsh","last_synced_at":"2026-05-24T09:02:38.834Z","repository":{"id":327648317,"uuid":"1109354935","full_name":"robinmordasiewicz/f5xc-xcsh","owner":"robinmordasiewicz","description":null,"archived":false,"fork":false,"pushed_at":"2026-05-16T07:23:43.000Z","size":208774,"stargazers_count":0,"open_issues_count":22,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-16T09:51:42.186Z","etag":null,"topics":["cli","f5xc","shell"],"latest_commit_sha":null,"homepage":"https://robinmordasiewicz.github.io/f5xc-xcsh/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/robinmordasiewicz.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-12-03T17:30:35.000Z","updated_at":"2026-05-16T07:15:04.000Z","dependencies_parsed_at":"2026-01-22T07:02:02.047Z","dependency_job_id":null,"html_url":"https://github.com/robinmordasiewicz/f5xc-xcsh","commit_stats":null,"previous_names":["robinmordasiewicz/vesctl","robinmordasiewicz/f5xcctl","robinmordasiewicz/xcsh"],"tags_count":465,"template":false,"template_full_name":null,"purl":"pkg:github/robinmordasiewicz/f5xc-xcsh","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robinmordasiewicz%2Ff5xc-xcsh","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robinmordasiewicz%2Ff5xc-xcsh/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robinmordasiewicz%2Ff5xc-xcsh/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robinmordasiewicz%2Ff5xc-xcsh/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/robinmordasiewicz","download_url":"https://codeload.github.com/robinmordasiewicz/f5xc-xcsh/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/robinmordasiewicz%2Ff5xc-xcsh/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33235802,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-19T15:49:41.270Z","status":"ssl_error","status_checked_at":"2026-05-19T15:49:22.917Z","response_time":58,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","f5xc","shell"],"created_at":"2025-12-30T00:18:17.077Z","updated_at":"2026-05-24T09:02:38.804Z","avatar_url":"https://github.com/robinmordasiewicz.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# xcsh\n\nF5 Distributed Cloud Shell - A command-line interface for managing F5 Distributed Cloud resources.\n\n**API Version:** v2.0.21\n\nBuilt with F5 Distributed Cloud API specifications.\n\nVersion v2.0.21 includes updated API specifications for enhanced functionality.\n\n## Documentation\n\nFull documentation is available at **[robinmordasiewicz.github.io/f5xc-xcsh](https://robinmordasiewicz.github.io/f5xc-xcsh)**\n\n## Claude Code Integration\n\nThis project includes a Claude Code skill for seamless AI assistant interaction with your locally installed xcsh binary.\n\n### /xcsh Skill\n\nThe `/xcsh` skill enables AI assistants to:\n\n- Access real-time xcsh capabilities from your local installation\n- Query resource specifications with field constraints and recommendations\n- Generate valid F5 XC configurations with proper validation\n- Provide intelligent suggestions based on F5 best practices\n\n**Quick Start** (in Claude Code):\n\n```bash\n/xcsh version    # Check installation\n/xcsh domains    # List available domains\n/xcsh spec healthcheck create  # Get resource spec (when routing is connected)\n```\n\nSee [docs/SKILLS.md](docs/SKILLS.md) for complete documentation.\n\n## Installation\n\n### Homebrew\n\n```bash\nbrew tap robinmordasiewicz/tap\nbrew install --cask xcsh\n```\n\n### Install Script\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/robinmordasiewicz/f5xc-xcsh/main/install.sh | sh\n```\n\n## Usage\n\n### Basic Command Structure\n\nThe CLI is organized around **domains** matching F5 Distributed Cloud API structure:\n\n```bash\nxcsh \u003cdomain\u003e \u003coperation\u003e \u003cresource-type\u003e [resource-name] [flags]\n```\n\n### Domain-Based Commands\n\nCommon domains include:\n\n| Domain                 | Purpose                                         |\n| ---------------------- | ----------------------------------------------- |\n| `virtual`              | HTTP, TCP, UDP load balancers and origin pools  |\n| `cloud_infrastructure` | AWS, Azure, GCP cloud sites and credentials     |\n| `waf`                  | Web application firewalls and security policies |\n| `dns`                  | DNS zones and load balancing                    |\n| `sites`                | Site management and virtual sites               |\n| `tenant_and_identity`  | User profiles and sessions                      |\n| `ai_services`          | AI assistant for natural language queries       |\n\n### Examples\n\n#### List Resources\n\n```bash\n# List HTTP load balancers in default namespace\nxcsh virtual list http_loadbalancer\n\n# List in specific namespace\nxcsh virtual list http_loadbalancer -ns production\n```\n\n#### Get a Specific Resource\n\n```bash\n# Get a load balancer configuration\nxcsh virtual get http_loadbalancer example-lb\n\n# Get from specific namespace as YAML\nxcsh virtual get http_loadbalancer example-lb -ns production -o yaml\n```\n\n#### Create a Resource\n\n```bash\n# Create from YAML file\nxcsh virtual create http_loadbalancer -f lb-config.yaml\n```\n\n#### Delete a Resource\n\n```bash\n# Delete a resource\nxcsh virtual delete http_loadbalancer example-lb -ns production\n```\n\n#### Apply (Create or Update)\n\n```bash\n# Apply from YAML (creates if not exists, updates if does)\nxcsh virtual apply http_loadbalancer -f lb-config.yaml\n```\n\n#### Get Help\n\n```bash\n# Show available domains\nxcsh --help\n\n# Show domain-specific operations\nxcsh virtual --help\n```\n\n## Development\n\n### Build from Source\n\n```bash\ngit clone https://github.com/robinmordasiewicz/f5xc-xcsh.git\ncd f5xc-xcsh\nnpm install\nnpm run build\n./dist/index.js version\n```\n\n### Domain Registry\n\nxcsh contains **38 domains** organized by functional area and automatically synchronized with F5 Distributed Cloud API specifications:\n\n- **Load Balancing**: virtual (HTTP, TCP, UDP load balancers and origin pools)\n- **Infrastructure**: cloud_infrastructure, sites, ce_management\n- **Security**: waf, bot_and_threat_defense, network_security\n- **Networking**: network, dns\n- **Observability**: observability, statistics, telemetry_and_insights\n- **Identity**: tenant_and_identity, users, authentication\n\n## License\n\nThis project is open source. See the LICENSE file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobinmordasiewicz%2Ff5xc-xcsh","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frobinmordasiewicz%2Ff5xc-xcsh","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frobinmordasiewicz%2Ff5xc-xcsh/lists"}