b3os-mac-app-shell

b3os-mac-app-shell is a skill for Claude Code, Codex from b3rys/b3rys-team-os. It costs 0 tokens per session (2,080 once invoked), scanned A, original, Apache-2.0.

A workflow for wrapping a web dashboard or web app in an Apple-native shell and packaging it as a Mac `.app`, with an optional iPhone companion. The shell displays the web app through Apple's web-view technology.

In plain words
What is it for?
It helps package URL-based web tools as Mac apps, and can support a read-only or matching iPhone shell when the required private project template and Mac build tools are available.
Why use it?
It provides a tested structure and highlights setup and window-sizing issues that can affect how the web app appears inside the installed app.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Good fit It helps package URL-based web tools as Mac apps, and can support a read-only or matching iPhone shell when the required private project template and Mac build tools are available.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/b3rys/b3rys-team-os/b3os-mac-app-shell
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add b3rys/b3rys-team-os --skill b3os-mac-app-shell
Clone the repo
git clone --depth 1 https://github.com/b3rys/b3rys-team-os

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for b3os-mac-app-shell

README.md
[![agentmods](https://agentmods.dev/badge/skills/b3rys/b3rys-team-os/b3os-mac-app-shell/github.svg)](https://agentmods.dev/skills/b3rys/b3rys-team-os/b3os-mac-app-shell)
Your own site
<a href="https://agentmods.dev/skills/b3rys/b3rys-team-os/b3os-mac-app-shell"><img src="https://agentmods.dev/badge/skills/b3rys/b3rys-team-os/b3os-mac-app-shell/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for b3os-mac-app-shell

Your own site · 80×15
<a href="https://agentmods.dev/skills/b3rys/b3rys-team-os/b3os-mac-app-shell"><img src="https://agentmods.dev/badge/skills/b3rys/b3rys-team-os/b3os-mac-app-shell.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 0 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,080 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00000 $0.02080
Opus 5 $0.00000 $0.01040
Sonnet 5 $0.00000 $0.00416
Haiku 4.5 $0.00000 $0.00208

Measured 9d ago against content hash f0f6471a41a9, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-08, from the pricing page.

Security

Grade A, and why

b3os-mac-app-shell scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 9d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/b3os-mac-app-shell/SKILL.md · 86 lines

How it starts

The opening of the file, as written. The whole thing — 86 lines — stays where its author put it; the contents beside it link to each section on GitHub.

b3os-mac-app-shell

웹앱을 Apple 네이티브 셸(.app)로 래핑하는 팀 표준 레시피. 별도 골격 저장소를 참조하며 코드를 복제하지 않는다 — 이 스킬은 "언제·어떻게·무엇을 조심"의 운영 지식이고, 실제 구현·빌드 스크립트는 골격에 있다.

★선행 조건 — 골격 저장소는 이 저장소에 들어있지 않다.★ 정본 골격은 b3rys 내부 비공개 저장소 mac-iphone-shell(SwiftUI multi-platform 라이브러리 + HostApp 패턴)이다. 접근 권한이 있는 팀원이 따로 clone해야 하고, 아래 절차와 references의 경로는 본인이 clone한 위치를 가리킨다(이 문서에서는 $SHELL_SKELETON으로 쓴다). 접근 권한이 없으면 이 스킬의 빌드 절차는 실행할 수 없다 — "검증된 함정"·"검증 절차" 절의 운영 지식만 참고 자료로 쓴다.

owner / 업데이트 책임자: agent A, developer (둘이 함께 유지·리뷰)

언제 쓰는가

  • 이미 있는 웹 대시보드/웹툴을 설치 가능한 Mac 앱(.app) 으로 내보내고 싶을 때 (예: b3os 대시보드 → b3os.app)
  • "맥앱으로 래핑한 티 안 나게, 라이트/다크 seamless, 창이 네이티브처럼" 요구
  • iPhone 동반 앱(같은 골격, read-only/동일 셸)도 필요할 때
  • ❌ 쓰지 않는 경우: 네이티브 UI가 본질인 앱(웹뷰가 아니라 SwiftUI 화면이 주). 그건 골격 없이 일반 SwiftUI로.

전제 · 요구사항 (이게 없으면 이 스킬은 못 쓴다)

  • macOS Sonoma 14+ (골격 deployment target). Xcode 16.2+ (xcodebuild -version). Swift toolchain 포함.
  • 배포(외부 공개)하려면 Apple Developer 계정 + Developer ID Application 인증서. 로컬/팀 테스트는 ad-hoc만으로 가능(서명 안 됨).
  • 이 스킬은 macOS 빌드 환경 전용 — Windows/Linux에선 .app 빌드 불가(셸 컨셉만 참고).
  • 핀(검증된 조합): macOS 14 / Xcode 16.2 / 골격 mac-iphone-shell 최신 main. 더 높은 버전은 빌드 후 §검증 통과 시 사용.

입력값 (앱마다 정하는 것)

무엇 어디서 설정
webURL 셸이 로드할 웹 주소 AppShellSettings.defaultWebURL (기본 http://localhost:7878/team) + 런타임 UserDefaults 키 AppShell.webURL로 덮어쓰기 가능
app name .app 표시 이름 골격의 $SHELL_SKELETON/scripts/package-macos-app.shAPP_NAME (예: b3os.app) / Xcode HostApp 프로젝트명
product name 빌드 산출 바이너리 같은 스크립트 PRODUCT_NAME (예: B3rysMacApp)
bundle id 번들 식별자 Xcode HostApp 프로젝트 (Signing & Capabilities)
WKAppBoundDomains 셸이 이동 가능한 도메인 화이트리스트 HostApp Info.plist (보안: limitsNavigationsToAppBoundDomains=true와 한 세트)

절차 (요약 — 상세는 골격 저장소의 docs/QuickStart.md "30분")

  1. 골격 라이브러리 가져오기 — 내부 비공개 저장소를 $SHELL_SKELETON으로 clone하거나 SPM 의존성으로 추가
  2. Xcode에서 App 프로젝트(HostApp) 생성 → AppShell 라이브러리 추가
  3. App entry를 AppShellRootView(셸)로 교체, webURL·환경 주입
  4. Info.plist: WKAppBoundDomains + 환경 도메인 설정
  5. Capabilities (서명용 — Apple Developer 계정)
  6. 빌드·실행: swift build / Xcode Run
  7. 배포용 .app 패키징: $SHELL_SKELETON/scripts/package-macos-app.sh.build/<APP_NAME> (테스트=ad-hoc 서명, 배포=notarize)

Read the full file on GitHub · 86 lines

Files

What ships with it

3 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 9d ago First seen · 86 lines · 0 tokens per session scan A f0f6471a41a9

Subscribe to this mod's changes

b3os-mac-app-shell is a skill published in the GitHub repository b3rys/b3rys-team-os (12 stars, last pushed today), licensed Apache-2.0. It costs nothing until one of its globs matches a file; then it loads 2,080 tokens. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.