feat: add startup launch support (#1421)
Add launch-at-startup support across the Electron desktop app and the web CLI. Electron now supports macOS launch-at-login through the native login item API. Login launches start OpenChamber in the background without opening a window, while Dock activation, deep links, and second-instance launches still open or focus the normal app window. The desktop Settings UI now exposes a localized launch-at-login toggle in Desktop Network Access. The web CLI now includes `openchamber startup status|enable|disable`, backed by native user services: - macOS: launchd LaunchAgent - Linux: systemd --user service - Windows: Task Scheduler Startup services run `openchamber serve --foreground` so the OS service manager owns process lifetime and restarts. Foreground service updates now defer restarts to the service manager instead of spawning duplicate CLI restarts. Startup services snapshot useful environment variables by default so provider tokens, PATH, SSH agent settings, and OpenCode configuration survive login/reboot starts. The snapshot avoids shell/session-only state, uses systemd-compatible env quoting on Linux, and avoids unused env artifacts on macOS. Also adds localized docs for startup services and environment variables.
This commit is contained in:
Bohdan Triapitsyn
committed by
GitHub
GitHub
parent
e97bf0d9dc
commit
2014303bc0
@@ -0,0 +1,134 @@
|
||||
---
|
||||
title: 환경 변수
|
||||
description: 환경 변수로 OpenChamber와 OpenCode 연동을 설정합니다.
|
||||
---
|
||||
|
||||
# 환경 변수
|
||||
|
||||
OpenChamber는 시작할 때 이 변수들을 읽습니다. 시작 서비스는 `openchamber startup enable` 실행 시 기본적으로 현재 환경의 snapshot을 저장하므로, 서비스에 적용할 변수를 바꾼 뒤에는 다시 실행하세요.
|
||||
|
||||
## OpenChamber 서버
|
||||
|
||||
### `OPENCHAMBER_HOST`
|
||||
|
||||
OpenChamber 웹 서버가 바인딩할 주소입니다. 다른 컴퓨터에서 접속해야 하면 `0.0.0.0`을 사용하세요.
|
||||
|
||||
### `OPENCHAMBER_UI_PASSWORD`
|
||||
|
||||
브라우저 UI 비밀번호입니다. localhost 밖으로 바인딩하거나 터널, 리버스 프록시를 사용할 때 설정하세요.
|
||||
|
||||
### `OPENCHAMBER_DATA_DIR`
|
||||
|
||||
OpenChamber 데이터 디렉터리를 바꿉니다. 기본값은 `~/.config/openchamber`입니다.
|
||||
|
||||
### `OPENCHAMBER_COMPRESS_API`
|
||||
|
||||
API 응답 압축을 제어합니다. `true` 또는 `1`은 켜고, `false` 또는 `0`은 끕니다.
|
||||
|
||||
### `OPENCHAMBER_SKIP_API_COMPRESSION`
|
||||
|
||||
`true` 또는 `1`이면 API 응답 압축을 끕니다. `OPENCHAMBER_COMPRESS_API`보다 우선합니다.
|
||||
|
||||
### `OPENCHAMBER_VERBOSE_REQUEST_LOGS`
|
||||
|
||||
`true` 또는 `1`이면 자세한 HTTP request logs를 켭니다.
|
||||
|
||||
### `OPENCHAMBER_UPDATE_API_URL`
|
||||
|
||||
업데이트 확인 API endpoint를 바꿉니다. 대부분의 사용자는 설정하지 않아도 됩니다.
|
||||
|
||||
### `OPENCHAMBER_PACKAGE_MANAGER`
|
||||
|
||||
자동 감지가 틀렸을 때 업데이트에 사용할 package manager를 강제로 지정합니다.
|
||||
|
||||
## OpenCode 서버
|
||||
|
||||
### `OPENCODE_HOST`
|
||||
|
||||
OpenChamber를 이미 실행 중인 OpenCode server에 연결합니다. 값은 명시적 포트가 있고 path, query, hash가 없는 `http` 또는 `https` origin이어야 합니다. `OPENCODE_HOST`는 `OPENCODE_PORT`보다 우선합니다.
|
||||
|
||||
### `OPENCODE_PORT`
|
||||
|
||||
OpenCode server 포트를 설정합니다. managed OpenCode에서는 이 포트를 요청하고, `OPENCODE_SKIP_START=true`와 함께 쓰면 해당 포트의 외부 서버에 연결합니다.
|
||||
|
||||
### `OPENCODE_SKIP_START`
|
||||
|
||||
`true`이면 OpenChamber가 자체 OpenCode server를 시작하지 않습니다.
|
||||
|
||||
### `OPENCHAMBER_OPENCODE_HOSTNAME`
|
||||
|
||||
OpenChamber가 관리하는 OpenCode server의 bind hostname입니다. 기본값은 `127.0.0.1`입니다.
|
||||
|
||||
### `OPENCODE_BINARY`
|
||||
|
||||
OpenChamber가 실행할 `opencode` executable 경로입니다.
|
||||
|
||||
### `OPENCODE_CONFIG`
|
||||
|
||||
특정 OpenCode config 파일 경로입니다.
|
||||
|
||||
### `OPENCODE_CONFIG_DIR`
|
||||
|
||||
agents, skills, snippets, config discovery에 사용할 OpenCode config 디렉터리입니다.
|
||||
|
||||
### `OPENCODE_DATA_DIR`
|
||||
|
||||
managed OpenCode server의 사용자 지정 데이터 디렉터리입니다.
|
||||
|
||||
### `OPENCODE_WSL_DISTRO`
|
||||
|
||||
Windows에서 OpenCode 연동에 사용할 WSL distro를 선택합니다.
|
||||
|
||||
### `OPENCHAMBER_OPENCODE_WSL_DISTRO`
|
||||
|
||||
WSL distro를 선택하는 OpenChamber 전용 alias입니다. 둘 다 설정하면 `OPENCODE_WSL_DISTRO`가 우선합니다.
|
||||
|
||||
### `OPENCODE_JWT_SECRET`
|
||||
|
||||
UI auth tokens 서명에 사용하는 secret입니다. 지속 실행 서비스에서는 긴 무작위 값을 사용하세요.
|
||||
|
||||
## Terminal 및 Git
|
||||
|
||||
### `OPENCHAMBER_TERMINAL_SHELL`
|
||||
|
||||
OpenChamber terminal sessions에서 사용할 shell executable입니다.
|
||||
|
||||
### `OPENCHAMBER_GIT_BINARY`
|
||||
|
||||
OpenChamber Git 기능에서 사용할 Git executable입니다.
|
||||
|
||||
### `GIT_BINARY`
|
||||
|
||||
Git executable의 대체 override입니다. OpenChamber 전용 설정에는 `OPENCHAMBER_GIT_BINARY`를 권장합니다.
|
||||
|
||||
### `OPENCHAMBER_GIT_READ_CACHE_TTL_MS`
|
||||
|
||||
Git-backed file reads cache의 TTL이며 단위는 밀리초입니다. 디버깅 중 cache를 끄려면 `0`으로 설정하세요.
|
||||
|
||||
## 음성 및 터널
|
||||
|
||||
### `OPENAI_API_KEY`
|
||||
|
||||
OpenAI-compatible services를 호출하는 OpenChamber 음성 기능에 사용하는 API key입니다.
|
||||
|
||||
### `OPENCHAMBER_ALLOW_REMOTE_OPENAI_COMPAT_URLS`
|
||||
|
||||
`true` 또는 `1`이면 음성 기능에서 원격 OpenAI-compatible base URLs를 허용합니다.
|
||||
|
||||
### `NGROK_AUTHTOKEN`
|
||||
|
||||
OpenChamber tunnel commands에서 사용하는 ngrok auth token입니다. `ngrok config add-authtoken <token>`으로도 설정할 수 있습니다.
|
||||
|
||||
## Runtime helpers
|
||||
|
||||
### `BUN_BINARY`
|
||||
|
||||
OpenChamber가 daemon processes를 시작할 때 사용할 Bun executable입니다.
|
||||
|
||||
### `BUN_INSTALL`
|
||||
|
||||
Bun 설치 루트입니다. OpenChamber는 daemon 시작과 업데이트를 위해 여기서 `bin/bun`을 찾습니다.
|
||||
|
||||
### `VITE_OPENCODE_URL`
|
||||
|
||||
Vite-built web app의 build-time API base URL입니다. 일반 CLI 또는 desktop 사용에서는 대부분 설정할 필요가 없습니다.
|
||||
@@ -44,6 +44,33 @@ openchamber stop
|
||||
|
||||
`openchamber`만 입력하면 서버가 백그라운드에서 시작됩니다. 터미널에 연결된 상태로 유지하려면 `--foreground`를 추가하세요.
|
||||
|
||||
## 로그인할 때 OpenChamber 시작하기
|
||||
|
||||
`startup enable`을 사용해 네이티브 사용자 서비스를 설치하세요. OpenChamber는 macOS에서 `launchd`, Linux에서 `systemd --user`, Windows에서 Task Scheduler를 사용합니다.
|
||||
|
||||
```bash
|
||||
openchamber startup enable
|
||||
openchamber startup status
|
||||
openchamber startup disable
|
||||
```
|
||||
|
||||
UI를 보호하려면 서비스를 활성화할 때 비밀번호를 설정하세요:
|
||||
|
||||
```bash
|
||||
OPENCHAMBER_UI_PASSWORD='secret' openchamber startup enable
|
||||
```
|
||||
|
||||
`startup enable`은 현재 환경의 스냅샷을 서비스에 저장해, 같은 셸에서 `openchamber`를 직접 실행한 것에 더 가깝게 동작하게 합니다. provider 토큰, `PATH`, SSH agent 설정, 기타 CLI auth/config 환경 변수가 유지됩니다. 최소한의 서비스 환경을 원하면 `--no-env-snapshot`을 사용하세요.
|
||||
|
||||
실행 중인 이 서비스의 터널은 별도로 관리할 수 있습니다:
|
||||
|
||||
```bash
|
||||
openchamber tunnel start --port 3000
|
||||
openchamber tunnel stop --port 3000
|
||||
```
|
||||
|
||||
터널을 중지해도 서비스나 앱은 재시작되지 않습니다.
|
||||
|
||||
## "OpenCode is restarting"
|
||||
|
||||
서버가 시작되거나 재시작되는 동안 OpenChamber는 "OpenCode is restarting" 상태를 표시하고 준비가 끝날 때까지 요청을 일시 중지합니다. 실행 직후나 재시작 직후에는 정상적인 동작입니다. 이 상태가 계속 사라지지 않으면 [OpenCode 연결](/ko/troubleshooting/opencode-connection/)을 참고하세요.
|
||||
|
||||
Reference in New Issue
Block a user