Tura

토큰 최적화 및 실행 효율성

Tura는 시스템 프롬프트와 컨텍스트를 반복적으로 전달하는 대신, 실행 가능한 명령 그래프를 구성하여 결정론적인 실행을 수행합니다. 이를 통해 대화형 오버헤드를 줄이고, 동일한 작업을 토큰 소비를 크게 줄이면서 완수할 수 있습니다.

매크로 CLI 명령 실행

에이전트는 ‘command_run’이라는 단일 매크로 도구를 사용하여 여러 단계의 실행 트리를 구성할 수 있습니다. 예를 들어, 코드 탐색, 패치 적용, 빌드, 테스트, 린트 검증과 같은 일련의 작업을 하나의 구조화된 워크플로우로 처리할 수 있습니다.

론리스 배경 추론(Backward Reasoning)

Tura는 현재 상태에서 목표로 순방향으로 추론하는 대신, 목표 상태를 먼저 추정한 후 현재 상태까지 역추론하는 전략을 사용합니다. 이는 통계적으로 더 일반적인 코드나 로직의 편향을 줄이고 문제의 근본 원인을 찾는 데 도움을 줍니다.

런타임 컨텍스트 및 프롬프트 관리

Tura는 컨텍스트를 런타임 상태 머신의 일부로 관리합니다. 태스크별 매뉴얼을 통해 활성 컨텍스트를 현재 작업에 맞게 범위를 지정하고, ‘task_status’를 통해 세션을 관리하며, compact_context 명령을 통해 정확한 실행 상태를 복원할 수 있습니다.

다운로드·설치 방법

Tura는 npm 패키지를 통해 전역 또는 로컬 프로젝트에 설치할 수 있습니다. 전역 설치 시 ‘npm install -g tura-ai’ 명령어를 사용합니다. 로컬 설치 시 ‘npm install tura-ai’로 설치한 후 ‘npx –no-install tura’를 통해 실행할 수 있습니다.

소스 코드를 직접 빌드하여 설치하는 것도 가능합니다. GitHub에서 저장소를 클론한 후 Windows PowerShell에서는 ‘.scriptsinstall.ps1’을, macOS/Linux에서는 ‘./scripts/install.sh’를 실행하여 환경 설정, 빌드, PATH 등록을 자동으로 수행합니다.

기본 사용법

설치 후 ‘tura’ 명령어로 터미널 사용자 인터페이스(TUI)를 실행할 수 있습니다. 초기 프롬프트와 함께 실행하려면 ‘tura “prompt”‘ 형식을 사용합니다. 직접적인 CLI 실행은 ‘tura exec “prompt”‘로 가능하며, 웹 게이트웨이 서버는 ‘tura_gateway’로 시작합니다. 그래픽 사용자 인터페이스는 ‘tura_gui’ 명령어로 실행합니다.

최초 실행 시 LLM 프로바이더를 구성하고 모델을 선택해야 합니다. npm 패키지에는 프로바이더 인증 정보가 포함되어 있지 않으므로 별도 설정이 필요합니다.

이런 경우에 유용합니다

대규모 코딩 작업에서 모델 토큰 소비를 줄이고 실행 효율성을 높이고자 하는 개발자에게 유용합니다. 여러 단계의 코드 수정, 빌드, 테스트 작업을 자동화하고자 할 때 매크로 명령을 통해 처리할 수 있습니다. 또한, 긴 세션에서 컨텍스트 관리와 상태 복원이 필요한 경우 런타임 컨텍스트 관리 기능이 도움이 됩니다.

지원 환경

Windows, macOS, Linux에서 사용 가능합니다. Windows 사용자는 Scoop 패키지 관리자를 통해 설치할 수 있습니다. npm을 통한 설치가 가장 간단한 방법이며, GitHub Packages를 통해서도 설치할 수 있습니다.

최신 버전

현재 제공되는 버전은 0.1.37입니다. 프로젝트의 로드맵과 업데이트 정보는 GitHub 저장소의 ROADMAP.md 파일에서 확인할 수 있습니다.

제한 사항·확인 사항

Tura는 프로바이더 인증 정보를 번들로 제공하지 않습니다. 사용 전에 LLM 프로바이더를 구성하고 모델을 선택해야 합니다. npm 패키지는 ‘postinstall’ 라이프사이클 스크립트를 실행하지 않으므로 설치 후 ‘tura’ 래퍼가 설치된 플랫폼 패키지를 직접 실행합니다.

소스 코드 설치 시 Windows PowerShell 사용자는 ‘-EnvironmentOnly’ 옵션을 사용하여 빌드 및 등록 없이 의존성 설정만 수행할 수 있습니다.