rebornstudio-terminalmac 0.0.0-stage → 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +24 -2
- package/install.mjs +190 -0
- package/package.json +34 -4
- package/skill/terminalmac-ko/SKILL.md +109 -0
package/README.md
CHANGED
|
@@ -1,3 +1,25 @@
|
|
|
1
|
-
#
|
|
1
|
+
# rebornstudio-terminalmac
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
AI 에이전트에게 내 맥 대신 별도의 가상 맥(macOS)을 내주고 그 화면을 터미널에서 보는 무료 오픈소스 **terminal-mac** 의 **한국어 설치 · 연결 안내 스킬**을 넣어 줍니다.
|
|
4
|
+
|
|
5
|
+
```
|
|
6
|
+
npx --yes rebornstudio-terminalmac
|
|
7
|
+
```
|
|
8
|
+
|
|
9
|
+
클로드 코드 안에서는 `!npx --yes rebornstudio-terminalmac`. 넣은 뒤 클로드 코드를 다시 켜고 「terminal-mac 가상 맥 설치 순서와 주의할 점 알려 줘」라고 말하세요.
|
|
10
|
+
|
|
11
|
+
| 공식 설치(README · 맥 터미널) | 클로드 코드 연결 |
|
|
12
|
+
|---|---|
|
|
13
|
+
| `curl -fsSL https://github.com/govijr/terminal-mac/releases/latest/download/get.sh \| bash` | `/plugin install terminal-mac --marketplace govijr/terminal-mac` |
|
|
14
|
+
|
|
15
|
+
- 이 패키지가 넣는 것은 `~/.claude/skills/terminalmac-ko/SKILL.md`(한국어 안내) 하나입니다. `--local` 이면 지금 폴더의 `.claude/skills/`.
|
|
16
|
+
- **terminal-mac 은 Govijr 의 것이며 싣거나 대신 설치하지 않습니다.** MIT 라 무료이고, 클로드 사용료는 따로 듭니다.
|
|
17
|
+
- terminal-mac 은 애플 실리콘 맥 · macOS 14 이상 전용입니다(공식 README). 윈도우 · 인텔 맥에서는 쓸 수 없습니다.
|
|
18
|
+
- 아직 초기 버전(early release candidate)이고, 완전히 격리된 환경이 아니라고 공식 README 가 밝힙니다. 배포 파일은 자체 서명 · 애플 공증 없음.
|
|
19
|
+
- 가상 맥에서 AI 가 한 일은 직접 확인하세요. 결과 보증 없음.
|
|
20
|
+
- 가입 · 로그인 · 키 입력이 없고 이 설치기는 네트워크를 쓰지 않습니다. 제휴 없음.
|
|
21
|
+
- 옵션: `--check` · `--dry-run` · `--local` · `--self-test`
|
|
22
|
+
- 한국어 안내 페이지: https://rebornstudio.kr/terminalmac
|
|
23
|
+
|
|
24
|
+
terminal-mac by Govijr, MIT: github.com/govijr/terminal-mac
|
|
25
|
+
안내 스킬 · 설치기: REBORN STUDIO (MIT). 기준일 2026-11-22 공식 README · docs/AGENT.md · docs/VALIDATION.md · LICENSE · 공식 API.
|
package/install.mjs
ADDED
|
@@ -0,0 +1,190 @@
|
|
|
1
|
+
#!/usr/bin/env node
|
|
2
|
+
/**
|
|
3
|
+
* REBORN STUDIO · terminalmac — **한국어 안내 스킬 하나를 ~/.claude/skills/terminalmac-ko 에 넣는다.**
|
|
4
|
+
*
|
|
5
|
+
* npx --yes rebornstudio-terminalmac 안내 스킬을 넣는다
|
|
6
|
+
* npx --yes rebornstudio-terminalmac --check 깔지 않고 지금 상태만 본다
|
|
7
|
+
* npx --yes rebornstudio-terminalmac --dry-run 무엇을 할지 보여 주기만 한다
|
|
8
|
+
* npx --yes rebornstudio-terminalmac --local 홈이 아니라 지금 폴더(.claude/skills)에 넣는다
|
|
9
|
+
* npx --yes rebornstudio-terminalmac --self-test 설치기 자체 시험 (네트워크 안 씀)
|
|
10
|
+
*
|
|
11
|
+
* ★terminal-mac 본체(govijr/terminal-mac)는 싣지도, 내려받아 깔지도, 재배포하지도 않는다.
|
|
12
|
+
* 설치 방법은 안내 스킬이 공식 명령 그대로 알려 줄 뿐이고, 설치는 사람이 직접 한다.
|
|
13
|
+
* ★우리가 쓴 것은 skill/terminalmac-ko/SKILL.md (한국어 안내) 하나다. 남의 파일을 싸 넣지 않는다.
|
|
14
|
+
* 폴더 이름을 terminalmac-ko 로 둬서 공식 스킬 이름(terminal-mac)과 겹치지 않게 한다.
|
|
15
|
+
* ★가입·로그인·키 입력을 하지 않는다. 키·토큰을 받거나 저장하지 않는다. 네트워크를 쓰지 않는다.
|
|
16
|
+
*/
|
|
17
|
+
import { existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
|
|
18
|
+
import { homedir } from "node:os";
|
|
19
|
+
import { dirname, join } from "node:path";
|
|
20
|
+
import { fileURLToPath } from "node:url";
|
|
21
|
+
|
|
22
|
+
const 여기 = dirname(fileURLToPath(import.meta.url));
|
|
23
|
+
const 원본 = join(여기, "skill");
|
|
24
|
+
const 회차 = "terminalmac";
|
|
25
|
+
const 폴더 = "terminalmac-ko";
|
|
26
|
+
const 안내주소 = `https://rebornstudio.kr/${회차}?utm_source=installer&utm_medium=cli&utm_campaign=${회차}`;
|
|
27
|
+
const 공식명령 = [
|
|
28
|
+
"curl -fsSL https://github.com/govijr/terminal-mac/releases/latest/download/get.sh | bash",
|
|
29
|
+
"/plugin install terminal-mac --marketplace govijr/terminal-mac",
|
|
30
|
+
];
|
|
31
|
+
|
|
32
|
+
const 색 = { 초: "\x1b[32m", 빨: "\x1b[31m", 노: "\x1b[33m", 회: "\x1b[90m", 청: "\x1b[36m", 굵: "\x1b[1m", 끝: "\x1b[0m" };
|
|
33
|
+
|
|
34
|
+
export function 옵션해석(argv) {
|
|
35
|
+
const 옵션 = new Set(), 모름 = [], 말 = [];
|
|
36
|
+
const 알려진 = new Set(["--check", "--dry-run", "--local", "--self-test"]);
|
|
37
|
+
for (const a of argv) {
|
|
38
|
+
if (a.startsWith("--")) (알려진.has(a) ? 옵션.add(a) : 모름.push(a));
|
|
39
|
+
else 말.push(a);
|
|
40
|
+
}
|
|
41
|
+
return { 옵션, 모름, 말 };
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
const 목적지 = (전역) => (전역 ? join(homedir(), ".claude", "skills") : join(process.cwd(), ".claude", "skills"));
|
|
45
|
+
|
|
46
|
+
function 펼치기(뿌리, 접두 = "", 모음 = []) {
|
|
47
|
+
for (const n of readdirSync(뿌리).sort()) {
|
|
48
|
+
const p = join(뿌리, n);
|
|
49
|
+
if (statSync(p).isDirectory()) 펼치기(p, 접두 + n + "/", 모음);
|
|
50
|
+
else 모음.push(접두 + n);
|
|
51
|
+
}
|
|
52
|
+
return 모음;
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
export function 안내스킬있나(자리) {
|
|
56
|
+
const f = join(자리, 폴더, "SKILL.md");
|
|
57
|
+
return existsSync(f) && statSync(f).size > 2000;
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
/* ══ 자기시험 (네트워크 안 씀) ═════════════════════════════════════ */
|
|
61
|
+
function 자기시험() {
|
|
62
|
+
const 결과 = [];
|
|
63
|
+
const T = (이름, ok) => 결과.push([이름, !!ok]);
|
|
64
|
+
const f = join(원본, 폴더, "SKILL.md");
|
|
65
|
+
const 본 = existsSync(f) ? readFileSync(f, "utf8").replace(/\r/g, "") : "";
|
|
66
|
+
|
|
67
|
+
T("skill/terminalmac-ko/SKILL.md 가 있고 빈 껍데기가 아니다", 본.length > 2000);
|
|
68
|
+
T("★머리말 name 이 폴더 이름과 같다", /^---\nname: terminalmac-ko\n/.test(본));
|
|
69
|
+
T("★폴더 이름이 공식 스킬 이름(terminal-mac)과 다르다", 폴더 !== "terminal-mac");
|
|
70
|
+
T("★skill/ 안에 안내 스킬 폴더 하나뿐이다(본체를 싣지 않는다)", (() => {
|
|
71
|
+
const 목록 = readdirSync(원본);
|
|
72
|
+
return 목록.length === 1 && 목록[0] === 폴더 && 펼치기(join(원본, 폴더)).join(",") === "SKILL.md";
|
|
73
|
+
})());
|
|
74
|
+
T("★description 에 부르는 말이 있다", /\ndescription: .*terminal-mac.*가상 맥 띄워 줘/.test(본));
|
|
75
|
+
T("★공식 명령 2줄이 전부 안내에 있다", 공식명령.every((m) => 본.includes(m)));
|
|
76
|
+
T("★공식 저장소 주소가 있다", 본.includes("https://github.com/govijr/terminal-mac"));
|
|
77
|
+
T("★확인 날짜가 있다", /2026-11-22 확인/.test(본));
|
|
78
|
+
T("★공식 첫 줄 원문을 옮긴다", 본.includes("A separate macOS desktop for computer-use agents, viewed and controlled from a terminal."));
|
|
79
|
+
T("★따로인 맥 원문을 옮긴다", 본.includes("The guest is a separate Mac: it has its own apps, files, accounts and permissions."));
|
|
80
|
+
T("★포인터 · 클립보드 원문을 옮긴다", 본.includes("without moving the physical Mac's pointer or changing its clipboard"));
|
|
81
|
+
T("★★초기 버전 원문을 옮긴다", 본.includes("early release candidate") && 본.includes("Live guest acceptance on a clean Mac is still pending."));
|
|
82
|
+
T("★★격리가 아니라는 원문을 옮긴다", 본.includes("This is not a network-isolated or hardened hostile-code environment."));
|
|
83
|
+
T("★★샌드박스로 쓰지 말라고 말한다", /안전한 샌드박스로 쓰지 않게 한다/.test(본));
|
|
84
|
+
T("★자체 서명 · 공증 없음 원문을 옮긴다", 본.includes("Releases are self-signed (no Apple notarization)"));
|
|
85
|
+
T("★설치기 검증 원문을 옮긴다", 본.includes("The installer downloads the latest release and verifies its SHA-256 before installing."));
|
|
86
|
+
T("★필요 조건 원문을 옮긴다", 본.includes("Apple silicon Mac, macOS 14 or later") && 본.includes("64 GiB"));
|
|
87
|
+
T("★볼 수 있는 터미널 원문을 옮긴다", 본.includes("Ghostty, Kitty or iTerm2"));
|
|
88
|
+
T("★윈도우 · 인텔 맥은 안 된다고 말한다", /윈도우 · 리눅스 · 인텔 맥 사용자에게는 쓸 수 없다/.test(본));
|
|
89
|
+
T("★up 과 미리 보기 명령을 옮긴다", 본.includes("terminal-mac up") && 본.includes("terminal-mac up --plan"));
|
|
90
|
+
T("★첫 설정이 자동이 아니라는 원문을 옮긴다", 본.includes("This is guided setup, not an unattended guest installation."));
|
|
91
|
+
T("★도우미 앱 자리와 두 권한을 옮긴다", 본.includes("/Volumes/My Shared Files/tools") && 본.includes("TerminalMacGuest.app") && 본.includes("Screen Recording") && 본.includes("Accessibility"));
|
|
92
|
+
T("★따로 넣는 두 줄을 옮긴다", 본.includes("claude mcp add terminal-mac -- terminal-mac mcp") && 본.includes("terminal-mac skills install"));
|
|
93
|
+
T("★다른 MCP 클라이언트 방법을 옮긴다", 본.includes("terminal-mac mcp --config"));
|
|
94
|
+
T("★MCP 도구 원문과 표기 차이를 밝힌다", 본.includes("screenshot, click, drag, scroll, type, key, status") && /move 까지 적는다/.test(본));
|
|
95
|
+
T("★내 화면을 건드리지 않는다는 원문을 옮긴다", 본.includes("They never touch your own desktop."));
|
|
96
|
+
T("★네트워크 끊는 법과 VPN 막힘을 옮긴다", 본.includes("terminal-mac network default --offline") && 본.includes("--network user"));
|
|
97
|
+
T("★지우는 명령이 없다는 것과 데이터 자리를 옮긴다", 본.includes("~/Library/Application Support/terminal-mac/machines/") && /지우는 명령은 아직 없다/.test(본));
|
|
98
|
+
T("★강제 종료 주의를 옮긴다", 본.includes("terminal-mac stop default") && /저장 안 한 작업이 사라질 수 있다/.test(본));
|
|
99
|
+
T("★설치는 사람이 치게 한다", /대신 실행하지 않는다/.test(본));
|
|
100
|
+
T("★get.sh 를 먼저 열어 보게 한다", /get\.sh 내용을 먼저 열어 보게 한다/.test(본));
|
|
101
|
+
T("★라이선스(MIT · 저작권자)를 옮긴다", 본.includes("Copyright (c) 2026 Govijr") && /MIT/.test(본));
|
|
102
|
+
T("★무료 원문을 옮긴다", 본.includes("terminal-mac is free and maintained in my own time"));
|
|
103
|
+
T("★클로드 사용료는 따로라고 말한다", /클로드 사용료\(구독이나 API\)는 따로/.test(본));
|
|
104
|
+
T("★결과를 보장하지 않는다고 말한다", /보장하지 않는다/.test(본));
|
|
105
|
+
T("★필요한 계정만 로그인하게 한다", /꼭 필요한 계정만 로그인/.test(본));
|
|
106
|
+
T("★이 안내가 본체를 대신하지 않는다고 말한다", /이 안내는 terminal-mac 을 대신하지 않는다/.test(본));
|
|
107
|
+
T("★공식 스킬과 다른 것임을 밝힌다", /공식 스킬\(이름 terminal-mac\)과는 다른 것이다/.test(본));
|
|
108
|
+
T("★키·토큰을 채팅에 붙이지 말라고 말한다", /채팅에 붙여 넣지 않/.test(본));
|
|
109
|
+
T("★본체는 제작자의 것 · 제휴 없음을 밝힌다", /제작자의 것/.test(본) && /제휴/.test(본) && 본.includes("Govijr"));
|
|
110
|
+
T("★성과 · 안전 약속 문구를 쓰지 않는다(금지 예시로만 등장)", (() => {
|
|
111
|
+
const 남은 = 본.replace(/"깔면 무조건 안전하다", "AI 가 알아서 완벽하게 해 준다" 같은 말을 하지 않는다/, "");
|
|
112
|
+
return !/무조건|완벽하게|100% 안전/.test(남은);
|
|
113
|
+
})());
|
|
114
|
+
T("★'에이아이' 대신 AI 로 쓴다", !/에이아이/.test(본));
|
|
115
|
+
T("★옵션 해석", 옵션해석(["--check"]).옵션.has("--check") && 옵션해석(["--zzz"]).모름.length === 1);
|
|
116
|
+
T("★없는 자리는 깔린 것으로 보지 않는다", !안내스킬있나(join(원본, "__없는자리__")));
|
|
117
|
+
T("★package.json files 에 install.mjs · skill/ 가 있다", (() => {
|
|
118
|
+
const p = JSON.parse(readFileSync(join(여기, "package.json"), "utf8"));
|
|
119
|
+
return (p.files || []).includes("install.mjs") && (p.files || []).includes("skill/") && p.bin && p.bin["rebornstudio-terminalmac"] === "install.mjs";
|
|
120
|
+
})());
|
|
121
|
+
T("★안내 주소에 회차 표시(utm)가 붙는다", 안내주소 === "https://rebornstudio.kr/terminalmac?utm_source=installer&utm_medium=cli&utm_campaign=terminalmac");
|
|
122
|
+
T("★★못 넣었으면 끝인사를 안 띄운다 (실패 분기가 끝인사보다 먼저 끝난다)", (() => {
|
|
123
|
+
const 글 = readFileSync(fileURLToPath(import.meta.url), "utf8");
|
|
124
|
+
const 실패 = 글.indexOf("if (!들어옴) {"), 끝 = 글.indexOf("/* ★끝인사");
|
|
125
|
+
return 실패 > 0 && 끝 > 실패 && /if \(!들어옴\) \{[^\n]*\n[^\n]*process\.exit\(1\)/.test(글);
|
|
126
|
+
})());
|
|
127
|
+
|
|
128
|
+
for (const [이름, ok] of 결과) console.log(` ${ok ? 색.초 + "✓" : 색.빨 + "✗"}${색.끝} ${이름}`);
|
|
129
|
+
const 실패 = 결과.filter(([, ok]) => !ok).length;
|
|
130
|
+
console.log(실패 ? `\n${색.빨}✗ 자기시험 ${실패}건 실패${색.끝}` : `\n${색.초}✓ 자기시험 ${결과.length}건 통과${색.끝}`);
|
|
131
|
+
return 실패 ? 1 : 0;
|
|
132
|
+
}
|
|
133
|
+
|
|
134
|
+
/* ══ 본 실행 ════════════════════════════════════════════════════ */
|
|
135
|
+
function 실행() {
|
|
136
|
+
const { 옵션, 모름, 말 } = 옵션해석(process.argv.slice(2));
|
|
137
|
+
if (옵션.has("--self-test")) process.exit(자기시험());
|
|
138
|
+
if (모름.length) { console.error(`${색.빨}✗ 모르는 옵션: ${모름.join(" ")}${색.끝}`); process.exit(2); }
|
|
139
|
+
if (말.length) { console.error(`${색.빨}✗ 이 설치기는 이름을 받지 않습니다: ${말.join(" ")}${색.끝} — 그냥 npx --yes rebornstudio-terminalmac`); process.exit(2); }
|
|
140
|
+
if (!existsSync(join(원본, 폴더, "SKILL.md"))) { console.error(`${색.빨}✗ 패키지 안에 skill/ 이 없습니다${색.끝} — 배포가 잘못된 것입니다.`); process.exit(2); }
|
|
141
|
+
const 자리 = 목적지(!옵션.has("--local"));
|
|
142
|
+
|
|
143
|
+
console.log(`${색.굵}AI 에게 가상 맥을 내주기 · terminal-mac${색.끝} ${색.회}— 한국어 안내${색.끝}`);
|
|
144
|
+
|
|
145
|
+
if (옵션.has("--check")) {
|
|
146
|
+
console.log(`\n${색.굵}상태${색.끝}`);
|
|
147
|
+
console.log(` ${안내스킬있나(자리) ? 색.초 + "✓" : 색.빨 + "✗"}${색.끝} 한국어 안내 스킬 ${색.회}(${join(자리, 폴더, "SKILL.md")})${색.끝}`);
|
|
148
|
+
console.log(` ${색.회}-${색.끝} terminal-mac 본체 ${색.회}(공식 명령으로 직접 설치합니다 · 여기서는 확인하지 않습니다)${색.끝}`);
|
|
149
|
+
console.log(`\n${색.회}보기만 했습니다. 넣으려면 옵션 없이 다시 실행하세요.${색.끝}`);
|
|
150
|
+
process.exit(0);
|
|
151
|
+
}
|
|
152
|
+
|
|
153
|
+
console.log(`\n${색.굵}할 일${색.끝}`);
|
|
154
|
+
console.log(` ${색.청}안내 스킬 넣기${색.끝} ${색.회}→ ${join(자리, 폴더, "SKILL.md")}${색.끝}`);
|
|
155
|
+
console.log(` ${색.회}terminal-mac 은 깔지 않습니다 — 공식 설치 명령은 안내 스킬과 아래 줄에 그대로 있습니다${색.끝}`);
|
|
156
|
+
if (옵션.has("--dry-run")) { console.log(`\n${색.노}--dry-run 이라 아무것도 하지 않았습니다.${색.끝}`); process.exit(0); }
|
|
157
|
+
|
|
158
|
+
const 출발 = join(원본, 폴더), 목표 = join(자리, 폴더);
|
|
159
|
+
for (const 상대 of 펼치기(출발)) {
|
|
160
|
+
const dst = join(목표, 상대);
|
|
161
|
+
mkdirSync(dirname(dst), { recursive: true });
|
|
162
|
+
writeFileSync(dst, readFileSync(join(출발, 상대)));
|
|
163
|
+
}
|
|
164
|
+
const 들어옴 = 안내스킬있나(자리);
|
|
165
|
+
console.log(`\n ${들어옴 ? 색.초 + "✓" : 색.빨 + "✗"}${색.끝} 한국어 안내 스킬 ${들어옴 ? "들어왔습니다" : "못 넣었습니다"}`);
|
|
166
|
+
if (!들어옴) {
|
|
167
|
+
console.error(`${색.빨}✗ 폴더 권한 문제일 수 있습니다.${색.끝} --local 로 지금 폴더에 넣어 보거나, 이 화면을 캡처해 ${안내주소} 의 안내를 보세요.`); process.exit(1);
|
|
168
|
+
}
|
|
169
|
+
|
|
170
|
+
console.log(`\n${색.초}${색.굵}✓ 끝났습니다${색.끝}`);
|
|
171
|
+
console.log(`${색.노}★ 클로드 코드를 껐다 켜야 새 스킬을 읽습니다.${색.끝}`);
|
|
172
|
+
console.log(`\n${색.굵}클로드 코드에 이렇게 말하면 됩니다${색.끝}`);
|
|
173
|
+
console.log(`${색.회}${"─".repeat(60)}${색.끝}`);
|
|
174
|
+
console.log(` ${색.청}terminal-mac 가상 맥 설치 순서와 주의할 점 알려 줘${색.끝}`);
|
|
175
|
+
console.log(` ${색.청}가상 맥 상태 확인하고 지금 화면 스크린샷 찍어 줘${색.끝}`);
|
|
176
|
+
console.log(`${색.회}${"─".repeat(60)}${색.끝}`);
|
|
177
|
+
console.log(`${색.굵}공식 설치 · 연결${색.끝} ${색.회}(2026-11-22 공식 README 기준 · 첫 줄은 맥 터미널, 둘째 줄은 클로드 코드 안)${색.끝}`);
|
|
178
|
+
for (const m of 공식명령) console.log(` ${m}`);
|
|
179
|
+
console.log(`${색.노}★ 애플 실리콘 맥 · macOS 14 이상 전용입니다. 윈도우 · 인텔 맥에서는 쓸 수 없습니다.${색.끝}`);
|
|
180
|
+
console.log(`${색.노}★ 아직 초기 버전이고, 완전히 격리된 환경이 아닙니다(공식 README). 배포 파일은 자체 서명 · 애플 공증 없음.${색.끝}`);
|
|
181
|
+
console.log(`${색.회}MIT 무료 · 클로드는 구독이나 API 사용료 따로 · 가상 맥에서 AI 가 한 일은 직접 확인.${색.끝}`);
|
|
182
|
+
console.log(`${색.회}terminal-mac 은 Govijr 의 것이며 이 설치기는 싣거나 대신 깔지 않았습니다. 제휴 없음 · 결과 보증 없음.${색.끝}`);
|
|
183
|
+
|
|
184
|
+
/* ★끝인사 — 넣기에 성공했을 때만 여기 온다. 가리키는 곳은 한국어 안내 페이지 하나뿐이다. */
|
|
185
|
+
console.log(`\n${색.굵}한국어 안내 페이지${색.끝} ${색.회}— 설치 · 첫 설정 · 연결 · 막히는 자리 · 바로 쓰는 말 예시까지${색.끝}`);
|
|
186
|
+
console.log(`${색.청}${안내주소}${색.끝}\n`);
|
|
187
|
+
process.exit(0);
|
|
188
|
+
}
|
|
189
|
+
|
|
190
|
+
실행();
|
package/package.json
CHANGED
|
@@ -1,6 +1,36 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "rebornstudio-terminalmac",
|
|
3
|
-
"version": "
|
|
4
|
-
"
|
|
5
|
-
"
|
|
6
|
-
|
|
3
|
+
"version": "1.0.0",
|
|
4
|
+
"description": "AI 에이전트에게 내 맥 대신 가상 맥을 내주는 무료 오픈소스 terminal-mac(govijr/terminal-mac)의 설치 · 연결 · 주의할 점을 한국어로 안내하는 스킬을 넣어 줍니다. terminal-mac 본체는 대신 설치하지 않습니다.",
|
|
5
|
+
"keywords": [
|
|
6
|
+
"claude",
|
|
7
|
+
"claude-code",
|
|
8
|
+
"skills",
|
|
9
|
+
"terminal-mac",
|
|
10
|
+
"macos",
|
|
11
|
+
"computer-use",
|
|
12
|
+
"korean"
|
|
13
|
+
],
|
|
14
|
+
"homepage": "https://rebornstudio.kr/terminalmac?utm_source=npm&utm_medium=registry&utm_campaign=terminalmac",
|
|
15
|
+
"license": "MIT",
|
|
16
|
+
"author": "REBORN STUDIO",
|
|
17
|
+
"type": "module",
|
|
18
|
+
"bin": {
|
|
19
|
+
"rebornstudio-terminalmac": "install.mjs"
|
|
20
|
+
},
|
|
21
|
+
"files": [
|
|
22
|
+
"install.mjs",
|
|
23
|
+
"skill/",
|
|
24
|
+
"README.md"
|
|
25
|
+
],
|
|
26
|
+
"engines": {
|
|
27
|
+
"node": ">=18"
|
|
28
|
+
},
|
|
29
|
+
"scripts": {
|
|
30
|
+
"test": "node install.mjs --self-test",
|
|
31
|
+
"check": "node install.mjs --check"
|
|
32
|
+
},
|
|
33
|
+
"publishConfig": {
|
|
34
|
+
"access": "public"
|
|
35
|
+
}
|
|
36
|
+
}
|
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: terminalmac-ko
|
|
3
|
+
description: AI 에이전트에게 내 맥 대신 별도의 가상 맥(macOS)을 내주고 그 화면을 터미널에서 보는 무료 오픈소스 terminal-mac(govijr/terminal-mac)의 설치 · 연결 · 주의할 점을 공식 방법 그대로 한국어로 안내한다. "terminal-mac", "터미널 맥", "가상 맥 띄워 줘", "AI 한테 맥 따로 주기", "맥 가상 머신 MCP", "컴퓨터 사용 에이전트 맥" 같은 말이 나오면 쓴다. terminal-mac 은 Govijr 의 것이며 우리가 만든 것이 아니다.
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# AI 에게 가상 맥을 내주기 — terminal-mac 한국어 안내
|
|
7
|
+
|
|
8
|
+
이 안내 스킬은 **REBORN STUDIO(rebornstudio.kr)가 쓴 것**이다. terminal-mac 은 Govijr 가 만들어 공개한 것이고, 우리는 제휴 관계가 없다.
|
|
9
|
+
공식 저장소 README · docs/AGENT.md · docs/VALIDATION.md · LICENSE · 공식 API 에서 읽은 내용만 옮겼다(**2026-11-22 확인** · 바뀔 수 있다).
|
|
10
|
+
이 스킬을 넣은 설치기는 terminal-mac 본체를 싣거나 대신 깔지 않았다. 이 안내는 terminal-mac 을 대신하지 않는다 — 실제로 가상 맥을 띄우고 조작하는 일은 공식 방법으로 설치한 terminal-mac 이 한다.
|
|
11
|
+
공식 스킬(이름 terminal-mac)과는 다른 것이다. 공식 스킬은 `terminal-mac skills install` 로 넣는다.
|
|
12
|
+
|
|
13
|
+
## 사용자에게 처음 말할 것
|
|
14
|
+
|
|
15
|
+
1. **무엇인가** — 공식 문구: A separate macOS desktop for computer-use agents, viewed and controlled from a terminal. 화면을 보고 클릭하는 AI 에게 내 맥이 아니라 별도의 가상 맥을 내주는 도구다.
|
|
16
|
+
2. **따로인 것** — 공식 문구: The guest is a separate Mac: it has its own apps, files, accounts and permissions. 내 맥에서 켜 둔 앱 · 로그인 상태를 물려받지 않는다.
|
|
17
|
+
3. **내 마우스 · 클립보드** — 공식 문구: without moving the physical Mac's pointer or changing its clipboard. AI 가 가상 맥에서 일하는 동안 내 맥의 포인터와 클립보드는 건드리지 않는다고 설명한다.
|
|
18
|
+
4. **아직 초기 버전** — 공식 문구: early release candidate. Live guest acceptance on a clean Mac is still pending. 만든 사람 스스로 실제 검증이 남았다고 적었다. 잘 안 될 수 있다고 먼저 말한다.
|
|
19
|
+
5. **격리가 아니다** — 공식 문구: This is not a network-isolated or hardened hostile-code environment. 기본 네트워크(NAT)에서는 가상 맥이 인터넷과 내 컴퓨터 · 같은 네트워크의 서비스에 닿을 수 있다. 믿을 수 없는 코드를 돌리는 안전한 샌드박스로 쓰지 않게 한다.
|
|
20
|
+
6. **비용** — MIT 라이선스라 무료다(공식 문구: terminal-mac is free and maintained in my own time). 가상 맥을 조작하게 할 클로드 사용료(구독이나 API)는 따로 든다. 가상 맥도 내 맥의 CPU · 메모리 · 저장 공간을 쓴다.
|
|
21
|
+
7. **보장하지 않는다** — AI 가 시킨 일을 반드시 해낸다고 보장하지 않는다. 가상 맥 안에서 한 일은 사람이 직접 확인한다.
|
|
22
|
+
|
|
23
|
+
| 항목 | 내용(2026-11-22) |
|
|
24
|
+
|---|---|
|
|
25
|
+
| 공식 저장소 | https://github.com/govijr/terminal-mac |
|
|
26
|
+
| 라이선스 · 별 | MIT · 2,911 |
|
|
27
|
+
| 최신 배포 | v0.2.0-6 (2026-11-03) |
|
|
28
|
+
| 먼저 있어야 하는 것 | Apple silicon Mac, macOS 14 or later · 처음 실행 때 인터넷 · 저장 공간(가상 맥 디스크 기본 64 GiB 논리 크기) |
|
|
29
|
+
| 터미널 안 화면 보기 | Ghostty, Kitty or iTerm2 (다른 터미널은 가상 맥 창이 따로 뜬다 · tmux 는 아직 안 됨) |
|
|
30
|
+
|
|
31
|
+
윈도우 · 리눅스 · 인텔 맥 사용자에게는 쓸 수 없다고 바로 말한다.
|
|
32
|
+
|
|
33
|
+
## 설치 (공식 README 그대로 · 사람이 직접 친다)
|
|
34
|
+
|
|
35
|
+
맥 터미널에:
|
|
36
|
+
|
|
37
|
+
```
|
|
38
|
+
curl -fsSL https://github.com/govijr/terminal-mac/releases/latest/download/get.sh | bash
|
|
39
|
+
```
|
|
40
|
+
|
|
41
|
+
공식 설명: The installer downloads the latest release and verifies its SHA-256 before installing. `~/.local/bin` 에 실행 파일 하나, `~/.local/lib/terminal-mac` 에 런타임을 둔다. 관리자 권한이 필요 없고 셸 설정을 고치지 않는다. `terminal-mac` 을 못 찾으면 `~/.local/bin` 을 PATH 에 넣는다.
|
|
42
|
+
배포 파일은 자체 서명이고 애플 공증을 받지 않았다(공식 문구: Releases are self-signed (no Apple notarization)). 설치할지는 사용자가 판단하게 하고, 원하면 get.sh 내용을 먼저 열어 보게 한다.
|
|
43
|
+
|
|
44
|
+
가상 맥 처음 띄우기:
|
|
45
|
+
|
|
46
|
+
```
|
|
47
|
+
terminal-mac up
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
애플에서 macOS 복원 이미지를 내려받아 설치하므로 시간이 걸린다. 미리 보기만 하려면 `terminal-mac up --plan`(네트워크 · 디스크 변경 없음).
|
|
51
|
+
|
|
52
|
+
이 명령들은 사용자가 직접 치게 한다. 사용자가 분명히 시키지 않았으면 대신 실행하지 않는다.
|
|
53
|
+
|
|
54
|
+
## 가상 맥 첫 설정 (한 번 · 사람이 직접)
|
|
55
|
+
|
|
56
|
+
공식 문구: This is guided setup, not an unattended guest installation.
|
|
57
|
+
|
|
58
|
+
1. 뜬 가상 맥 창에서 macOS 초기 설정을 마치고 계정을 만든다.
|
|
59
|
+
2. 가상 맥 안에서 Finder → `/Volumes/My Shared Files/tools` → `TerminalMacGuest.app` 을 한 번 연다.
|
|
60
|
+
3. 도우미 앱의 두 단추로 **Screen Recording** 과 **Accessibility** 를 가상 맥 안에서 허용한다. 내 맥(호스트)에는 이 권한이 필요 없다.
|
|
61
|
+
4. 가상 맥을 로그인한 채로 둔다. 로그아웃 · 잠금 상태면 AI 가 조작하지 못한다.
|
|
62
|
+
|
|
63
|
+
## AI 도구에 연결 (공식 README)
|
|
64
|
+
|
|
65
|
+
클로드 코드 안에서 플러그인 하나로(MCP 서버 + 스킬):
|
|
66
|
+
|
|
67
|
+
```
|
|
68
|
+
/plugin install terminal-mac --marketplace govijr/terminal-mac
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
따로 넣을 때:
|
|
72
|
+
|
|
73
|
+
```
|
|
74
|
+
claude mcp add terminal-mac -- terminal-mac mcp
|
|
75
|
+
terminal-mac skills install
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
다른 MCP 클라이언트(Cursor · VS Code · Codex · Windsurf 등)는 `terminal-mac mcp --config` 출력을 그 도구의 MCP 설정에 붙인다.
|
|
79
|
+
MCP 도구: README 는 screenshot, click, drag, scroll, type, key, status 를 적고, docs/AGENT.md 는 move 까지 적는다(표기가 다르다 — 실제 목록은 연결 뒤 확인하게 한다).
|
|
80
|
+
공식 문구: The tools only drive the guest helper. They never touch your own desktop.
|
|
81
|
+
|
|
82
|
+
## 막히는 자리
|
|
83
|
+
|
|
84
|
+
- 터미널 안 화면 보기는 Ghostty · Kitty · iTerm2 에서만 된다. 보는 중 Ctrl+G 는 맥 단축키 모음, Ctrl+] 는 보기 끝내기(가상 맥은 계속 돈다).
|
|
85
|
+
- VPN · 프록시 앱(TUN 모드)이 켜져 있으면 가상 맥이 오프라인처럼 보일 수 있다. README 는 `--network user` 를 안내한다.
|
|
86
|
+
- 네트워크 길을 끊으려면 멈춘 가상 맥에 `terminal-mac network default --offline`. 일부 macOS 설정은 네트워크가 필요할 수 있다.
|
|
87
|
+
- 권한을 켰는데도 `terminal-mac action NAME status` 가 false 면 `terminal-mac action NAME permissions`.
|
|
88
|
+
- 가상 맥을 지우는 명령은 아직 없다. 데이터는 `~/Library/Application Support/terminal-mac/machines/` 에 있다.
|
|
89
|
+
- 멈추기는 `terminal-mac stop default`. `--force` 는 가상 맥 안의 저장 안 한 작업이 사라질 수 있다.
|
|
90
|
+
- 가상 맥 복제 · 되돌리기 · 완전 자동 설정은 아직 없다고 README 가 적는다.
|
|
91
|
+
|
|
92
|
+
## 이렇게 말하게 한다
|
|
93
|
+
|
|
94
|
+
- "가상 맥 상태 확인하고 지금 화면 스크린샷 찍어 줘"
|
|
95
|
+
- "가상 맥에서 사파리 열고 이 주소 들어가서 화면 보여 줘"
|
|
96
|
+
- "내 맥 말고 가상 맥에서만 이 앱 설치하고 실행해 봐"
|
|
97
|
+
- "가상 맥이 로그인 화면이면 멈추고 나한테 알려 줘"
|
|
98
|
+
|
|
99
|
+
가상 맥에는 꼭 필요한 계정만 로그인하게 한다. 가상 맥 안에서 로그인한 계정은 AI 가 그대로 쓸 수 있기 때문이다.
|
|
100
|
+
|
|
101
|
+
## 하지 않는 말
|
|
102
|
+
|
|
103
|
+
"깔면 무조건 안전하다", "AI 가 알아서 완벽하게 해 준다" 같은 말을 하지 않는다. 격리 · 보안을 약속하지 않는다.
|
|
104
|
+
비밀번호 · API 키 · 토큰을 채팅에 붙여 넣지 않게 한다.
|
|
105
|
+
|
|
106
|
+
## 출처 · 권리
|
|
107
|
+
|
|
108
|
+
terminal-mac 은 제작자의 것이다. MIT License · Copyright (c) 2026 Govijr. 복사하거나 고쳐서 나눌 때는 저작권 · 라이선스 문구를 남긴다. 저희는 제휴가 없다.
|
|
109
|
+
한국어 안내 페이지: https://rebornstudio.kr/terminalmac
|