add-dns-record

Add or update a DNS record in Cloudflare for the meskill.farm domain.

Parameter Handling

If parameters are missing from $ARGUMENTS, use mcp_question to gather them:

mcp_question({
  questions: [
    {
      question: "What is the DNS record name (subdomain)?",
      header: "Record Name",
      options: [
        { label: "Enter name...", description: "e.g., myservice, myservice.x (for testing)" }
      ]
    },
    {
      question: "What should this record point to?",
      header: "Target",
      options: [
        { label: "pilaster.meskill.farm", description: "Main web services host" },
        { label: "monolith.meskill.farm", description: "Infrastructure services" },
        { label: "zenith.meskill.farm", description: "AI/GPU workloads" },
        { label: "chassis.meskill.farm", description: "AI development workstation" },
        { label: "Enter custom target...", description: "Specify IP or hostname" }
      ]
    }
  ]
})

Expected $ARGUMENTS format: <record_name> <target> [record_type]

• Example: myservice pilaster.meskill.farm
• Example with type: myservice pilaster.meskill.farm CNAME

Commands

List existing records

cfcli --domain meskill.farm ls

Add CNAME record

cfcli --domain meskill.farm --type CNAME add <name> <target>

Add with Cloudflare proxy (orange cloud)

cfcli --domain meskill.farm --type CNAME --activate add <name> <target>

Update existing record

cfcli --domain meskill.farm --type CNAME edit <name> <target>

Delete record

cfcli --domain meskill.farm --type CNAME rm <name>

DNS Record Types

| Type | Use Case | Example | |------|----------|---------| | CNAME | Service aliases | ai.meskill.farm → obelisk.meskill.farm | | A | Direct IP mapping | host.meskill.farm → 10.55.20.21 | | TXT | Verification, SPF | Mail configuration |

Naming Conventions

| Environment | Pattern | Host | |-------------|---------|------| | Production | <service>.meskill.farm | Various | | Testing | <service>.x.meskill.farm | zenith | | Internal (tunnel) | <service>-int.meskill.farm | Various |

Container Hosts

| Host | DNS Entry | |------|-----------| | zenith | zenith.meskill.farm | | obelisk | obelisk.meskill.farm | | monolith | monolith.meskill.farm | | pilaster | pilaster.meskill.farm |

Example

# Add new service pointing to pilaster
/add-dns-record myservice pilaster.meskill.farm

# Add testing subdomain
/add-dns-record myservice.x zenith.meskill.farm

# Add with Cloudflare proxy
cfcli --domain meskill.farm --type CNAME --activate add myservice pilaster.meskill.farm

Verification

# Check DNS propagation
dig myservice.meskill.farm

# Flush local DNS cache
sudo systemd-resolve --flush-caches