{"id":50355595,"url":"https://github.com/custardcream98/better-remote-control","last_synced_at":"2026-05-29T22:30:39.885Z","repository":{"id":346166565,"uuid":"1188196888","full_name":"custardcream98/better-remote-control","owner":"custardcream98","description":"Your local terminal, on your phone.","archived":false,"fork":false,"pushed_at":"2026-03-23T03:11:42.000Z","size":1206,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-23T06:36:55.844Z","etag":null,"topics":["claude-code","cloudflare-tunnel","mobile","terminal"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/custardcream98.png","metadata":{"files":{"readme":"README.ko.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-21T18:42:16.000Z","updated_at":"2026-03-23T03:11:45.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/custardcream98/better-remote-control","commit_stats":null,"previous_names":["custardcream98/better-remote-control"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/custardcream98/better-remote-control","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/custardcream98%2Fbetter-remote-control","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/custardcream98%2Fbetter-remote-control/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/custardcream98%2Fbetter-remote-control/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/custardcream98%2Fbetter-remote-control/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/custardcream98","download_url":"https://codeload.github.com/custardcream98/better-remote-control/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/custardcream98%2Fbetter-remote-control/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33673627,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-29T02:00:06.066Z","response_time":107,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["claude-code","cloudflare-tunnel","mobile","terminal"],"created_at":"2026-05-29T22:30:34.310Z","updated_at":"2026-05-29T22:30:34.909Z","avatar_url":"https://github.com/custardcream98.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n\u003cimg src=\"docs/logo.svg\" alt=\"brc 로고\" width=\"80\"\u003e\n\n# Better Remote Control\n\n**내 로컬 터미널을, 내 폰에서.**\n\nCloudflare Tunnel 기반 모바일 최적화 웹 터미널.\\\n[Claude Code](https://docs.anthropic.com/en/docs/claude-code)를 어디서든 쓸 수 있습니다.\n\n\u003cbr\u003e\n\n\u003ca href=\"README.md\"\u003eEnglish\u003c/a\u003e\n\n\u003cbr\u003e\n\n\u003cimg src=\"docs/screenshots/hero-terminal.png\" alt=\"brc에서 Claude Code 실행\" width=\"300\"\u003e\n\n\u003c/div\u003e\n\n---\n\n## 왜 만들었나?\n\n[Claude Code Remote Control](https://github.com/anthropics/claude-code)은 불안정합니다. 대체제를 찾아봤지만 불필요한 기능이 많거나 버그투성이였습니다. 그래서 **brc**를 직접 만들었습니다 — 로컬 터미널을 폰에 띄우는 것, 그 하나에만 집중한 도구입니다.\n\n## 시작하기\n\n### 설치 (Node.js 불필요)\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/custardcream98/better-remote-control/main/install.sh | sh\n```\n\n또는 [GitHub Releases](https://github.com/custardcream98/better-remote-control/releases)에서 바이너리를 직접 다운로드할 수 있습니다.\n\n### npm으로 설치\n\n```bash\nnpx better-remote-control\n```\n\n### 소스에서 빌드\n\n```bash\ngit clone https://github.com/custardcream98/better-remote-control.git\ncd better-remote-control\npnpm install \u0026\u0026 cd client \u0026\u0026 pnpm install \u0026\u0026 cd ..\npnpm run build \u0026\u0026 pnpm start\n```\n\n터미널에 QR 코드가 나타나면 폰으로 스캔하고, 비밀번호를 입력하면 끝입니다.\n\n## 기능\n\n\u003ctable\u003e\n\u003ctr\u003e\n\u003ctd width=\"50%\"\u003e\n\n\u003cimg src=\"docs/screenshots/hero-terminal.png\" alt=\"Claude Code 터미널\" width=\"280\"\u003e\n\n\u003c/td\u003e\n\u003ctd width=\"50%\"\u003e\n\n### Claude Code 원격 제어\n\n로컬에서 돌아가는 Claude Code를 어디서든 — 소파에서, 침대에서, 이동 중에. 폰과 브라우저만 있으면 됩니다.\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd width=\"50%\"\u003e\n\n### 멀티 세션\n\n여러 세션을 동시에 — Claude Code 하나, 개발 서버 하나, 테스트 하나. 탭 한 번으로 전환합니다.\n\n\u003c/td\u003e\n\u003ctd width=\"50%\"\u003e\n\n\u003cimg src=\"docs/screenshots/hero-sessions.png\" alt=\"멀티 세션 홈\" width=\"280\"\u003e\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003ctr\u003e\n\u003ctd width=\"50%\"\u003e\n\n\u003cimg src=\"docs/screenshots/quick-keys.png\" alt=\"퀵 키\" width=\"280\"\u003e\n\n\u003c/td\u003e\n\u003ctd width=\"50%\"\u003e\n\n### 모바일 특수 키\n\n엄지 접근성을 고려한 키 배열:\n\n- \u003ckbd\u003e←\u003c/kbd\u003e \u003ckbd\u003e↓\u003c/kbd\u003e \u003ckbd\u003e↑\u003c/kbd\u003e \u003ckbd\u003e→\u003c/kbd\u003e \u003ckbd\u003eTab\u003c/kbd\u003e \u003ckbd\u003eEsc\u003c/kbd\u003e — 하단 배치, 바로 닿는 곳\n- \u003ckbd\u003eCtrl+C\u003c/kbd\u003e \u003ckbd\u003e⇧Tab\u003c/kbd\u003e \u003ckbd\u003eOpt+↵\u003c/kbd\u003e \u003ckbd\u003e/\u003c/kbd\u003e — 상단 배치, 보조 키\n- 화살표 키 길게 누르면 반복 입력\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n### 이미지 업로드\n\n카메라나 갤러리에서 이미지를 선택하면 서버에 업로드되고, 파일 경로가 터미널에 자동 삽입됩니다. Claude Code에 이미지를 넘길 때 유용합니다.\n\n### 슬립 방지\n\n`caffeinate`로 맥북을 깨워둡니다. 덮개를 닫아도 터미널이 계속 실행됩니다. 전원 연결 필요.\n\n### 자동 재연결\n\n연결이 끊겨도 자동으로 재접속하며 터미널 히스토리를 그대로 복원합니다. 출력이 유실되지 않습니다.\n\n### 보안\n\n비밀번호 인증, 속도 제한 (5회 / 60초), CSRF 보호, timing-safe 비교. 인증 토큰은 `HttpOnly` + `SameSite=Strict` 쿠키로 관리됩니다.\n\n## 사용법\n\n```bash\nbrc [옵션]\n```\n\n| 옵션                  | 설명                                |\n| --------------------- | ----------------------------------- |\n| `-p, --port \u003cport\u003e`   | 포트 번호 (기본: `4020`)            |\n| `--password \u003cpw\u003e`     | 비밀번호 지정 (기본: 자동 생성)     |\n| `-s, --shell \u003cshell\u003e` | 쉘 경로 (기본: `$SHELL`)            |\n| `-c, --cwd \u003cdir\u003e`     | 기본 작업 디렉토리 (기본: `$HOME`)  |\n| `--command \u003ccmd\u003e`     | 세션 시작 시 자동 실행할 명령어     |\n| `--no-tunnel`         | Cloudflare Tunnel 비활성화 (로컬만) |\n| `--no-caffeinate`     | 슬립 방지 비활성화                  |\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e사용 예시\u003c/b\u003e\u003c/summary\u003e\n\n```bash\n# Claude Code 원격 실행\nbrc --command \"claude --dangerously-skip-permissions\"\n\n# 특정 프로젝트에서 시작\nbrc --cwd ~/my-project\n\n# 로컬 네트워크만 (터널 없이)\nbrc --no-tunnel\n\n# 비밀번호 직접 지정\nbrc --password mysecretpassword\n```\n\n\u003c/details\u003e\n\n## 사전 요구사항\n\n원격 접속을 위해 **cloudflared**가 필요합니다:\n\n```bash\nbrew install cloudflared   # macOS\n# 또는 https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/downloads/ 참고\n```\n\ncloudflared 없이도 `--no-tunnel` 옵션으로 로컬 네트워크에서 사용할 수 있습니다.\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cb\u003e소스에서 빌드할 경우\u003c/b\u003e\u003c/summary\u003e\n\n| 요구사항          | 설치                             |\n| ----------------- | -------------------------------- |\n| **Node.js** \u003e= 18 | [nodejs.org](https://nodejs.org) |\n| **pnpm**          | `npm install -g pnpm`            |\n\n\u003c/details\u003e\n\n## 라이선스\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcustardcream98%2Fbetter-remote-control","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcustardcream98%2Fbetter-remote-control","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcustardcream98%2Fbetter-remote-control/lists"}