Jiayuan Zhang
576f20f2c7
refactor(cli): separate install from setup, redesign CLI configuration flow ( #888 )
...
Decouple install.sh from environment configuration — install.sh now only
installs the CLI binary (and optionally Docker via --with-server), while
all environment configuration moves to `multica setup` subcommands.
Key changes:
- install.sh: remove config writes, rename --local to --with-server
- multica setup: add cloud/self-host subcommands with --server-url,
--app-url, --port, --frontend-port flags and --profile support
- Add config overwrite protection with interactive prompt
- Remove redundant commands: `config local`, `auth login` alias
- Replace silent multica.ai fallbacks with explicit errors
- Onboarding wizard: dynamically show correct setup command for
Cloud vs Self-host environments
- Update all docs, landing page, and install scripts for consistency
2026-04-13 22:32:10 +08:00
Jiayuan Zhang
b0ee214154
feat: streamline self-hosting with one-click setup ( #724 )
...
* feat: streamline self-hosting experience with one-click setup
- Add `make selfhost` / `make selfhost-stop` for one-command Docker deployment
- Add `multica setup` CLI command (auto-detect local server, configure, login, start daemon)
- Add `multica config local` CLI command (configure for localhost defaults)
- Restructure SELF_HOSTING.md: simplified 4-step guide, moved advanced config to SELF_HOSTING_ADVANCED.md
- Add SELF_HOSTING_AI.md for AI agents to follow
- Document 888888 master verification code for non-production environments
- Document how to stop services
- Fix brew install typo: `multica-cli` → `multica` in SELF_HOSTING.md and self-hosting.mdx
- Update README.md and README.zh-CN.md with simplified self-host instructions
- Update CLI_AND_DAEMON.md with new setup/config local commands
* feat: add one-command installer script (curl | bash)
Add scripts/install.sh that handles the full setup in one command:
Self-host (default):
curl -fsSL .../install.sh | bash
→ Checks Docker, clones repo, starts services, installs CLI, configures
Cloud (CLI only):
curl -fsSL .../install.sh | bash -s -- --cloud
→ Installs CLI via Homebrew or binary download
Features:
- OS detection (macOS/Linux) with architecture support (amd64/arm64)
- Homebrew install with binary download fallback
- Idempotent: re-running updates existing installation
- Colored output with non-TTY fallback
- Docker availability check with helpful error messages
Updated docs (README, SELF_HOSTING, self-hosting.mdx, SELF_HOSTING_AI) to
show curl | bash as the primary install method.
* refactor: default install to cloud mode, add --local for self-host
- install.sh default is now cloud (CLI only, connects to multica.ai)
- Self-host uses --local flag: curl ... | bash -s -- --local
- Restructured README following Hermes Agent style:
- Quick Install section front and center with curl | bash
- CLI command reference table
- Self-host as a callout under Quick Install
- Removed redundant "Multica Cloud" / "CLI" sections
- Updated all docs (SELF_HOSTING, self-hosting.mdx, SELF_HOSTING_AI,
README.zh-CN) to use --local flag for self-host curl command
* docs: remove redundant AI agent install snippet from README CLI section
* docs: add daemon stop command to README quick install sections
* feat: add --stop flag to install.sh for easy self-host shutdown
Users who installed via `curl ... | bash -s -- --local` can now stop
all services with `curl ... | bash -s -- --stop`. The stop command
shuts down Docker Compose services and the daemon.
Also updated SELF_HOSTING.md stopping section to show both methods.
2026-04-12 00:50:17 +08:00
