AndroidHarness는 스마트폰에서 실행되는 코딩 에이전트입니다. 실제 프로젝트에서 바로 사용할 수 있으며, 파일을 읽고 편집하고, 셸 명령어를 실행하고, Git을 관리하고, 웹 브라우저를 제어하고, MCP 도구를 실행합니다. PC는 필요하지 않습니다.
MIT 라이선스에 따라 오픈 소스로 제공됩니다: https://github.com/Sanuu7/AndroidHarness
에이전트 런타임
코딩 에이전트와 채팅: 실시간 응답, 사고 블록, 대화형 도구 카드를 제공합니다. 스킬, 코드, PDF 파일을 첨부할 수 있습니다. 실행 중 후속 작업을 대기열에 추가하거나 알림을 통해 작업을 승인할 수 있습니다. 체크포인트는 앱을 다시 시작해도 유지됩니다. 이중 계획 기능을 통해 실행 전에 검사 및 계획을 수립합니다. 포그라운드 서비스는 화면이 꺼져도 실행을 유지합니다.
57가지 내장 도구
- 파일: read_file, write_file, edit_file, multi_edit(퍼지 찾기/바꾸기), apply_patch(롤백 기능 포함), grep, search_files, file_info, 일괄 복사, 이동, 삭제
- 셸: 타임아웃 및 프로세스 그룹 정리 기능이 있는 셸, 백그라운드 데몬 관리자(shell_background, bg_list, bg_kill).
- Git: git_status, git_diff, git_log, git_show(패치 보기), git_commit, git_branch, git_branch_manage, git_checkout, 업스트림 복구 기능이 있는 git_push, git_pull.
- 시스템 및 진단: 패키지 및 태그 필터가 있는 read_logcat, doctor 자가 진단 도구 모음, env_status 프로브.
- 이미지 및 웹: 이미지 모델용 read_image, PDF 텍스트 추출, 웹 검색(키리스, Brave, Tavily), 웹 가져오기, 바이너리 감지 기능이 있는 http_request.
- 에이전트 및 메모리: memory_read, memory_write, memory_search, todo_write 실시간 추적, ask_user 프롬프트, 작업(병렬 하위 에이전트), pkg_search, pkg_install, pkg_list.
모델 컨텍스트 프로토콜(MCP)
MCP를 통해 외부 도구 생태계를 연결합니다.
- stdio, HTTP 및 서버 전송 이벤트(SSE)를 통해 서버에 연결합니다.
- Claude Desktop 또는 MCP JSON 파일을 붙여넣어 구성을 가져옵니다.
- 서버는 에이전트 런타임에 사용자 지정 도구를 동적으로 노출합니다.
- 인증된 서비스를 위한 Chrome Custom Tabs를 통한 내장 OAuth 2.0 기능을 제공합니다.
- 작업 공간별 승인 및 HMAC 무결성 검증을 통해 실행을 보호합니다.
에이전트 브라우저(13개 도구)
browser_navigate, browser_click, browser_type, browser_scroll, browser_wait_for, browser_eval, browser_get_logs, browser_screenshot, browser_back, browser_forward, browser_refresh, browser_get_url, browser_get_dom 등 13개 도구를 활용한 헤드리스 브라우저 자동화 기능을 제공합니다. 개발자 도구, 장치 프레임, 원터치 버그 수정 기능을 통해 웹 앱을 미리 볼 수 있습니다.
파일, 편집기, 터미널
다중 선택 및 일괄 작업을 지원하는 작업 공간 파일 관리자. 구문 강조 표시(Kotlin, Java, Python, JS, TS, HTML, Shell), 줄 번호, 무제한 실행 취소, 정규 표현식 검색, 인코딩 유지 저장 기능을 갖춘 코드 편집기. 나란히 보기 방식의 시각적 차이점 비교 뷰어. 대화형 터미널 세션.
자동화 및 빌드
WorkManager를 통한 예약된 백그라운드 자동화: 스케줄 플래너, 사전 설정 간격, 실행 기록, 알림. Gradle 명령 및 테스트 스위트용 빌드 및 테스트 대시보드, 실시간 로그 및 빌드 실패 시 에이전트를 통한 원터치 수정.
모델 및 캐싱
내장 Harness 공급자를 통한 키리스 액세스 또는 Anthropic, Gemini, OpenAI 또는 사용자 지정 URL용 API 키 사용. 지연 시간 프로브, 정확한 가격 및 실시간 비용 추적 기능을 갖춘 라이브 카탈로그. 즉각적인 캐시 모니터링: 적중률, 미스율, 읽기/쓰기 토큰, 적중률. 캐시 최적화 단계(기본 설정부터 최상위 설정까지).
설계부터 안전함
실행 계층: Shizuku, Linux 툴체인(bash, git, python, node), toybox sh 대체 기능. 셸 정책으로 작업 영역을 제한합니다. 비밀 키 삭제 도구로 API 키를 안전하게 보호합니다. 네 가지 권한 모드: 모두 확인, 위험 항목 확인, 완전 자동, 전체 액세스. 생체 인식 앱 잠금 기능.
스킬 및 메모리
23가지 기본 마크다운 스킬(기획, TDD, 디버깅, 아키텍처)과 사용자 지정 스킬을 제공합니다. 실시간 할 일 추적, 리포지토리 맵 코드베이스 인덱싱, Groq Whisper 음성 입력, 세션 포크, 영구 메모리 기능을 지원합니다.
시작하기
1. 프로젝트 파일에 대한 저장소 액세스 권한을 부여합니다.
2. 내장된 키리스 공급자를 사용하거나 설정에서 API 키를 입력합니다.
3. (선택 사항): 권한 있는 셸 실행을 위해 Shizuku에 연결합니다.
분석, 광고, 추적 기능이 전혀 없습니다. 데이터는 구성된 엔드포인트로만 전송됩니다. GitHub에서 문제를 보고해 주세요.
기기에서 사용할 수 있는 AI 코딩 도구: 셸, 파일, 코드 편집기, Git 및 MCP.