콘텐츠로 이동
Vikasit Code
app.header.homeapp.header.docs

TUI

Vikasit Code 터미널 사용자 인터페이스 사용.

Vikasit Code는 LLM과 함께 프로젝트 작업을 하기 위한 대화형 터미널 인터페이스(TUI)를 제공합니다.

Vikasit Code를 실행하면 현재 디렉토리에서 TUI가 시작됩니다.

Terminal window
vikasit

또는 특정 작업 디렉토리에 대해 시작할 수 있습니다.

Terminal window
vikasit /path/to/project

TUI에 들어가면 메시지를 입력하여 프롬프트할 수 있습니다.

Give me a quick summary of the codebase.

파일 참조

@를 사용하여 메시지에서 파일을 참조할 수 있습니다. 이것은 현재 작업 디렉토리에서 퍼지(fuzzy) 파일 검색을 수행합니다.

How is auth handled in @packages/functions/src/api/index.ts?

파일의 내용이 자동으로 대화에 추가됩니다.

Bash 명령

!로 메시지를 시작하여 셸 명령을 실행합니다.

!ls -la

명령의 출력은 도구 결과로 대화에 추가됩니다.

명령

Vikasit Code TUI를 사용할 때 / 뒤에 명령 이름을 입력하여 작업을 빠르게 실행할 수 있습니다. 예를 들어:

/help

대부분의 명령에는 기본 리더 키인 ctrl+x를 사용하는 키바인드도 있습니다. 더 알아보기.

사용 가능한 모든 슬래시 명령은 다음과 같습니다:

connect

Vikasit Code에 공급자를 추가합니다. 사용 가능한 공급자 중에서 선택하고 API 키를 추가할 수 있습니다.

/connect

compact

현재 세션을 압축합니다. 별칭: /summarize

/compact

키바인드: ctrl+x c

details

도구 실행 세부 정보 토글.

/details

키바인드: ctrl+x d

editor

메시지 작성을 위한 외부 편집기를 엽니다. EDITOR 환경 변수에 설정된 편집기를 사용합니다. 더 알아보기.

/editor

키바인드: ctrl+x e

exit

Vikasit Code를 종료합니다. 별칭: /quit, /q

/exit

키바인드: ctrl+x q

export

현재 대화를 Markdown으로 내보내고 기본 편집기에서 엽니다. EDITOR 환경 변수에 설정된 편집기를 사용합니다. 더 알아보기.

/export

키바인드: ctrl+x x

help

도움말 대화 상자를 표시합니다.

/help

키바인드: ctrl+x h

init

AGENTS.md 파일을 생성하거나 업데이트합니다. 더 알아보기.

/init

키바인드: ctrl+x i

models

사용 가능한 모델 목록을 표시합니다.

/models

키바인드: ctrl+x m

new

새 세션을 시작합니다. 별칭: /clear

/new

키바인드: ctrl+x n

redo

이전에 실행 취소한 메시지를 다시 실행합니다. /undo를 사용한 후에만 사용할 수 있습니다.

내부적으로 Git을 사용하여 파일 변경 사항을 관리합니다. 따라서 프로젝트가 Git 저장소여야 합니다.

/redo

키바인드: ctrl+x r

sessions

세션 목록을 표시하고 세션 간을 전환합니다. 별칭: /resume, /continue

/sessions

키바인드: ctrl+x l

share

현재 세션을 공유합니다. 더 알아보기.

/share

키바인드: ctrl+x s

themes

사용 가능한 테마 목록을 표시합니다.

/themes

키바인드: ctrl+x t

thinking

대화에서 생각/추론 블록의 가시성을 토글합니다. 활성화하면 확장된 사고를 지원하는 모델의 추론 과정을 볼 수 있습니다.

/thinking

undo

대화의 마지막 메시지를 실행 취소합니다. 가장 최근의 사용자 메시지, 모든 후속 응답 및 모든 파일 변경 사항을 제거합니다.

내부적으로 Git을 사용하여 파일 변경 사항을 관리합니다. 따라서 프로젝트가 Git 저장소여야 합니다.

/undo

키바인드: ctrl+x u

unshare

현재 세션 공유를 취소합니다. 더 알아보기.

/unshare

Editor setup

/editor와 /export 명령 모두 EDITOR 환경 변수에 지정된 편집기를 사용합니다.

Terminal window
# Example for nano or vim
export EDITOR=nano
export EDITOR=vim


# For GUI editors, VS Code, Cursor, VSCodium, Windsurf, Zed, etc.
# include --wait
export EDITOR="code --wait"

영구적으로 설정하려면 셸 프로필(~/.bashrc, ~/.zshrc 등)에 추가하십시오.

인기 있는 편집기 옵션은 다음과 같습니다:

  • code - Visual Studio Code
  • cursor - Cursor
  • windsurf - Windsurf
  • nvim - Neovim editor
  • vim - Vim editor
  • nano - Nano editor
  • notepad - Windows Notepad
  • subl - Sublime Text

일부 편집기는 차단 모드에서 실행하려면 명령줄 인수가 필요합니다. --wait 플래그는 편집기 프로세스가 닫힐 때까지 차단되도록 합니다.

구성

tui.json (또는 tui.jsonc) 파일을 통해 TUI 동작을 사용자 정의할 수 있습니다.

tui.json
{
  "$schema": "https://opencode.ai/tui.json",
  "theme": "vikasit",
  "keybinds": {
    "leader": "ctrl+x"
  },
  "scroll_speed": 3,
  "scroll_acceleration": {
    "enabled": true
  },
  "diff_style": "auto"
}

이는 서버/런타임 동작을 구성하는 vikasit.json과는 별개입니다.

옵션

  • theme - UI 테마를 설정합니다. 더 알아보기.
  • keybinds - 키보드 단축키를 사용자 정의합니다. 더 알아보기.
  • scroll_acceleration.enabled - 부드럽고 자연스러운 스크롤을 위해 macOS 스타일의 스크롤 가속을 활성화합니다. 활성화하면 빠른 스크롤 제스처로 스크롤 속도가 증가하고 느린 움직임에서는 정밀하게 유지됩니다. 이 설정은 scroll_speed보다 우선하며 활성화 시 이를 덮어씁니다.
  • scroll_speed - 스크롤 명령을 사용할 때 TUI 스크롤 속도를 제어합니다 (최소: 0.001, 소수점 값 지원). 기본값은 3입니다. 참고: scroll_acceleration.enabled가 true로 설정되면 무시됩니다.
  • diff_style - diff 렌더링 방식을 제어합니다. "auto"는 터미널 너비에 적응하고, "stacked"는 항상 단일 열 레이아웃을 표시합니다.

VIKASIT_TUI_CONFIG를 사용하여 사용자 정의 TUI 설정 경로를 로드할 수 있습니다.

사용자 정의

명령 팔레트(ctrl+x h 또는 /help)를 사용하여 TUI 보기의 다양한 측면을 사용자 정의할 수 있습니다. 설정은 다시 시작해도 유지됩니다.

사용자 이름 표시

채팅 메시지에 사용자 이름이 표시되는지 여부를 토글합니다. 다음을 통해 액세스:

  • 명령 팔레트: “username” 또는 “hide username” 검색
  • 설정은 자동으로 유지되며 TUI 세션 간에 기억됩니다.