Skip to content

apps-in-toss-community/agent-plugin

Repository files navigation

agent-plugin

한국어 · English

AI 코딩 에이전트 안에서 앱인토스 미니앱을 생성·개발·테스트·배포까지 할 수 있게 해주는 커뮤니티 플러그인입니다. 현재 Claude Code를 지원하며, Codex 등 다른 에이전트는 후속 Phase에서 추가됩니다.

목표

@ait-co/devtools, sdk-example, @ait-co/polyfill, 커뮤니티 docs를 엮어 하나의 통합된 경험을 제공합니다. 현재 제공하는 slash command:

  • /ait new — 새 미니앱 스캐폴딩
  • /ait docs <topic> — 큐레이트된 SDK 문서를 세션에 로드
  • /ait inject-devtools / /ait inject-polyfill — 기존 프로젝트에 설정 주입
  • /ait status / /ait logs — console-cli 기반 상태 조회
  • /ait auth-setup — oidc-bridge 연결 구성
  • /ait debug — 브라우저 디버깅 안내 (devtools 패널 · window.__ait · 브라우저 DevTools). 폰 안 번들의 on-device CDP 디버깅은 진행 중
  • /ait deploy — 미니앱 배포

전체 skill 목록과 의존 repo는 CLAUDE.md의 "Skills" 표 참고.

배포 구조

단일 repo에서 여러 AI 코딩 에이전트 marketplace로 듀얼 배포합니다 (Figma mcp-server-guide 패턴).

agent-plugin/
├── shared/                  # source of truth (skills, commands, templates)
│   ├── skills/              # SKILL.md 번들
│   ├── commands/            # slash command 진입점 (얇은 래퍼)
│   └── templates/           # 스캐폴딩 템플릿
├── .claude-plugin/          # Claude Code plugin + marketplace manifest (Phase 1, 현재)
└── .codex-plugin/           # Codex (Phase 3, 스펙 확정 후)

shared/가 source of truth입니다. 실로직은 skill에 담고, slash command는 얇은 래퍼. 아키텍처·의사결정 배경은 CLAUDE.md 참고.

설치

Claude Code에서 marketplace를 추가하고 플러그인을 설치합니다:

/plugin marketplace add apps-in-toss-community/agent-plugin
/plugin install ait@aitc

설치 후 /ait 명령(/ait new, /ait deploy 등)을 사용할 수 있습니다.

Codex / Gemini CLI / Cursor / Windsurf는 Phase 2+ 예정입니다. CLAUDE.md의 "배포 phases" 참고.

개발 환경

Pre-commit hook

선택 사항이지만 권장합니다. clone 후 표준 pre-commit hook을 활성화하면 staged 파일에 biome check이 자동으로 돌아 push 전에 lint 문제를 잡아줍니다:

git config core.hooksPath .githooks

활성화하지 않아도 CI에서 동일한 검사가 enforcement layer로 동작하므로, hook을 활성화하지 않은 contributor도 PR 단계에서 lint 실패를 볼 수 있습니다.

텔레메트리

/ait 명령을 실행하면 버전·플랫폼만 포함된 익명 사용 신호(Tier 0)가 하루 1회 자동 수집됩니다. IP·이름·코드 등 식별 정보는 수집하지 않습니다.

비활성화 — 셸 프로필이나 .env에 아래를 추가하세요:

export AITC_TELEMETRY=off

또는 ~/.config/aitc-agent-plugin/telemetry.jsontier0OptOut: true 플래그로도 비활성화할 수 있습니다.

Tier 0 (자동 수집)과 Tier 1 (향후 선택적 동의) 비교, 데이터 삭제 방법은 https://docs.aitc.dev/privacy를 참고하세요.

현황

전체 로드맵은 organization landing page 참조.


커뮤니티 오픈소스 프로젝트입니다.

About

Community plugin for building Apps in Toss mini-apps — supports both Claude Code and OpenAI Codex (WIP)

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors