Skip to content

ChatClash Documentation

chatclash is a single-machine Mihomo management tool. It manages local runtime files, subscription-backed config generation, and ChatEnv-backed proxy validation on the machine where it runs.

chatclash init
chatclash sub set -i
chatclash mihomo install --daemon
chatclash sub update
chatclash mihomo start
chatclash status
chatclash --tree
chatenv test -t chatclash

Entry points

  • CLI Tree: runtime command tree generated by chatclash --tree.
  • CLI Design: responsibility boundaries and Python API mapping.
  • Release: release gates and publishing workflow.

Safety model

ChatEnv remains the system of record for operator-owned values, including CHATCLASH_HOME, CHATCLASH_SUBSCRIPTION_URL, CHATCLASH_PROXY_AUTH, and CHATCLASH_SUBCONVERTER_URL. Subscription URL and proxy auth are sensitive and must stay masked in normal output.