chsrc(1)

🦋 NAME

chsrc — Change Source for every software on every platform from the command line ✨ like it literally does what it says, no cap, one CLI to swap sources for everything.

This is chsrc(1) from the RubyMetric chsrc fam, bestie — buckle up 🎀

---

🌸 SYNOPSIS

chsrc <command> [options] [dish] [mirror]

That's the whole vibe check: a command, some options, then maybe a dish and maybe a mirror. Simple. Iconic. Periodt 💅

---

💖 DESCRIPTION

Okay so here's the tea — chsrc is organized into four little families of commands and I'm gonna walk you through each one, no skipping, we're doing all of it 🫶

基本命令 (basic commands) 🧚

• help — prints this help. also answers to h, -h, and --help because it's that girl with the many nicknames.
• issue — go peek at the related issue.
• list (or ls, or l) — lists the available mirrors, plus the dishes you're allowed to change the source of.
• list mirror/dish — lists the available mirrors, or the dishes you can switch sources on. And list os/lang/ware lists the switchable operating systems / programming languages / software. literally so organized 💅

测速命令 (speed test commands) 🔥

• measure / cesu <dish> — runs a speed test against every source for that dish. all of them. we're thorough here.

查看配置命令 (peek-at-the-config commands) 🔍

• list <dish> — shows the available sources for that dish and which features it supports.
• get <dish> — shows how that dish's current source is doing / which source it's on.

换源命令 (the actual source-swapping commands) 👑

• set <dish> — swaps the source. it auto-run a speed test first, then picks the fastest one for you 🏃‍♀️💨
• set <dish> first — swaps the source using the one the maintenance team speed-tested as number one.
• set <dish> <mirror> — swaps to a specific mirror you name (you can find them via list <dish>).
• set <dish> <https://url> — swaps to your very own custom source URL, main character energy, you do you 🎀
• reset <dish> — resets it back to the source upstream defaults to.

---

✨ OPTIONS ✨

• -dry — Dry Run, bestie. it simulates the whole source-swap process; the command only prints what it would do and does not actually run it. rehearsal era 💅
• -scope — sets the scope of the source swap. the values you can pick are: project|user|system|default (check what your dish supports with ls <dish>).
• -ipv6 — do the speed test over IPv6.
• -en / -english — output in English.
• -no-color — output with no color at all.

---

💀 EXIT STATUS

• 0 — ran normally; usually means the source swap succeeded 🎉
• 1 — an error caused by your environment, like a missing command 😭
• 2 — chsrc doesn't support this yet. not implemented, soz 🙈
• 3 — a mirror/source-info error caused by the maintainer 🫠
• 4 — fatal error, caused by an internal bug 💀
• 5 — fatal unknown error, which usually means an internal unknown bug. yeah. that one. 😬

---

🌈 EXAMPLES

# 测速，寻找最快者，换源
$ chsrc set ruby

# 列出可用的镜像站
# 使用 RubyChina 作为镜像站
$ chsrc ls  ruby
$ chsrc set ruby rubychina

# 可以使用自定义URL
$ chsrc set ruby https://gems.ruby-china.com/

# 使用维护团队测试的最快镜像站
$ chsrc set ruby first

Look at that. flawless. ate and left no crumbs 🔥

---

🍓 FILES

We follow the No UFO (Unidentified File Objects) principle: https://www.yuque.com/ccmywish/blog/no-ufo

So there will be no files stored on your computer at all! not one! your filesystem stays clean, bestie 🧚✨

---

💜 AUTHOR

Written by Aoran Zeng, Heng Guo and contributors. (See chsrc.c)

---

🎀 REPORTING BUGS

On Gitee: https://gitee.com/RubyMetric/chsrc/issues On GitHub: https://github.com/RubyMetric/chsrc/issues

come yell at us (lovingly) 🫶

---

👑 COPYRIGHT

Copyright (C) 2026 Aoran Zeng, Heng Guo. License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html> This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.

ok that warranty bit is real — NO WARRANTY, to the extent permitted by law. don't come for us 💀

---

version v0.2.6, dated 2026-08-12 — that's the whole chsrc(1) page, mwah, ily, go change some sources 💖🦋✨