hostlink-cli

CLI for the HostLink platform — built for humans and AI agents.

Installation

npm install -g @hostlink/hostlink-cli

Authentication

Obtain your access token from the HostLink portal, then save it:

hostlink set-token YOUR_TOKEN

AI Agent Skills

This repo ships Agent Skills (SKILL.md files) for every command — ready to use with GitHub Copilot, Cursor, and any MCP-compatible AI agent.

# Install all hostlink skills at once
npx skills add https://github.com/HostLink/hostlink-cli

# Or pick only what you need
npx skills add https://github.com/HostLink/hostlink-cli/tree/main/skills/hostlink-me
npx skills add https://github.com/HostLink/hostlink-cli/tree/main/skills/hostlink-clients
npx skills add https://github.com/HostLink/hostlink-cli/tree/main/skills/hostlink-domains
npx skills add https://github.com/HostLink/hostlink-cli/tree/main/skills/hostlink-quotations
npx skills add https://github.com/HostLink/hostlink-cli/tree/main/skills/hostlink-quotation-items

Commands

hostlink me

Show the current logged-in user's profile.

hostlink me
hostlink me --json

hostlink clients

Manage clients.

# List clients
hostlink clients list
hostlink clients list --limit 20 --offset 0
hostlink clients list --search "HostLink"
hostlink clients list --json

# Get a client by ID
hostlink clients get <id>
hostlink clients get <id> --json

# Update a client
hostlink clients update <id> --client-name "New Name" --client-email "[email protected]"

# Delete a client
hostlink clients delete <id>

Update options:

| Option | Description | |---|---| | --client-name | Client name | | --client-email | Email | | --client-phone | Phone | | --client-fax | Fax | | --client-addr1~3 | Address lines | | --client-city | City | | --client-website | Website | | --br-no | BR number | | --br-expiry-date | BR expiry date | | --remark | Remark | | --join-date | Join date | | --suspend-date | Suspend date | | --termination-date | Termination date | | --bill-name | Billing name | | --bill-email | Billing email | | --bill-phone | Billing phone |

hostlink domains

Manage domains.

# List domains
hostlink domains list
hostlink domains list --client <client_id>
hostlink domains list --search "example.com"
hostlink domains list --json

# Get a domain by ID
hostlink domains get <id>
hostlink domains get <id> --json

# Add a domain
hostlink domains add --client-id <id> --domain-name "example.com" --expiry-date "2027-01-01" --registrar "GoDaddy"

# Update a domain
hostlink domains update <id> --expiry-date "2028-01-01" --remark "renewed"

# Delete a domain
hostlink domains delete <id>

Add / Update options:

| Option | Description | |---|---| | --client-id | Client ID | | --domain-name | Domain name | | --expiry-date | Expiry date | | --creation-date | Creation date | | --registrar | Registrar | | --primary-dns | Primary DNS | | --secondary-dns | Secondary DNS | | --domain-user-id | Domain user ID | | --domain-password | Domain password | | --domain-type | Domain type | | --remark | Remark | | --server-id | Server ID | | --status | Status | | --is-project | Mark as project | | --is-vm | Mark as VM |

hostlink quotations

Manage quotations.

# List quotations
hostlink quotations list
hostlink quotations list --client <client_id>
hostlink quotations list --search "ABC Ltd"
hostlink quotations list --status "pending"
hostlink quotations list --json

# Get a quotation by ID
hostlink quotations get <id>
hostlink quotations get <id> --json

# Add a quotation
hostlink quotations add --client-id <id> --client-name "ABC Ltd" --quotation-date "2026-03-20" --due-date "2026-04-20"

# Update a quotation
hostlink quotations update <id> --status "approved" --sign-date "2026-03-25"

# Delete a quotation
hostlink quotations delete <id>

Add / Update options:

| Option | Description | |---|---| | --client-id | Client ID | | --client-name | Client name | | --quotation-date | Quotation date (YYYY-MM-DD) | | --due-date | Due date (YYYY-MM-DD) | | --sign-date | Sign date (YYYY-MM-DD) | | --email | Email | | --phone | Phone | | --addr1~3 | Address lines | | --city | City | | --note | Note | | --remark | Remark | | --header | Header text | | --status | Status | | --service-type | Service type | | --quotation-type | Quotation type | | --renew | Mark as renewal |

hostlink quotation-items

Manage items within a quotation. Each quotation can have multiple items.

# List all items in a quotation
hostlink quotation-items list <quotation_id>
hostlink quotation-items list <quotation_id> --json

# Get an item by ID
hostlink quotation-items get <id>
hostlink quotation-items get <id> --json

# Add an item to a quotation
hostlink quotation-items add --quotation-id <id> --name "Web Hosting" --unit-price 500 --unit-month 12 --unit-quantity 1

# Update an item
hostlink quotation-items update <id> --unit-price 600 --discount 10

# Delete an item
hostlink quotation-items delete <id>

Add / Update options:

| Option | Description | |---|---| | --quotation-id | Quotation ID (required for add) | | --name | Item name (required for add) | | --unit-price | Unit price | | --unit-month | Number of months (default: 1) | | --unit-quantity | Quantity | | --discount | Discount percentage | | --remark | Remark | | --sequence | Display sequence order | | --service-id | Service ID | | --domain-id | Domain ID | | --optional | Mark as optional item | | --accept | Mark as accepted | | --hidden-price | Hide price | | --hidden-quantity | Hide quantity | | --hidden-number | Hide number | | --page-break | Insert page break after item |

Global Options

All list commands support:

| Option | Description | |---|---| | -l, --limit <n> | Max records to return (default: 50) | | -o, --offset <n> | Records to skip (default: 0) | | --json | Output as JSON |

License

MIT © HostLink