tfx-profile

name	tfx-profile
description	Codex/Antigravity CLI 프로파일·모델 관리 인터랙티브 UI. tfx-route가 사용하는 프로파일 목록 조회, 모델 변경, effort 조정, 추가/삭제를 AskUserQuestion 기반 인터랙티브 선택지로 수행합니다. Use when: codex profile, codex model, gemini profile, gemini model, 프로파일 변경, 모델 변경, effort 변경, codex 설정, gemini 설정, profile manager, 프로파일 관리, 어떤 모델, tfx profile
argument-hint	[--list] [--codex | --gemini]

tfx-profile — Codex/Antigravity 프로파일 매니저

CLI 프로파일의 모델/effort를 AskUserQuestion 선택지로 관리합니다. Codex(~/.codex/config.toml + ~/.codex/<profile>.config.toml)와 Antigravity(~/.gemini/triflux-profiles.json) 모두 지원.

워크플로우

Step 0: CLI 선택

인자에 --codex 또는 --gemini가 있으면 해당 CLI로 직행. 없으면 AskUserQuestion으로 선택:

question: "어느 CLI의 프로파일을 관리하시겠습니까?"
header: "CLI"
options:
  - label: "Codex"
    description: "~/.codex/config.toml (TOML)"
  - label: "Antigravity"
    description: "~/.gemini/triflux-profiles.json (JSON)"

---

Codex 워크플로우

Step 1: Codex 설정 읽기 + 현재 상태 표시

~/.codex/config.toml의 top-level 기본값과 ~/.codex/*.config.toml 프로파일 파일을 읽어 테이블을 출력한다:

| 프로파일 | 모델 | Effort |
|----------|------|--------|
| gpt56_terra_high | 프로필 설정의 현재 모델 | high |
| ...  | ...           | ...  |

기본 모델(top-level model)과 기본 effort도 함께 표시.

Step 2: 작업 선택 (AskUserQuestion)

question: "어떤 작업을 하시겠습니까?"
header: "작업"
options:
  - label: "프로파일 모델 변경"
    description: "기존 프로파일의 모델/effort를 수정"
  - label: "기본 모델 변경"
    description: "top-level default 모델/effort 수정"
  - label: "프로파일 추가"
    description: "새 프로파일 생성"
  - label: "프로파일 삭제"
    description: "기존 프로파일 제거"

Step 3: 선택에 따른 세부 플로우

프로파일 모델 변경

1. AskUserQuestion으로 프로파일 선택
2. AskUserQuestion으로 프로필/alias 선택:

   options:
     - label: "gpt56_terra_high" → 기본 고품질 (Recommended)
     - label: "gpt56_terra_med"  → 균형형
     - label: "gpt56_luna_low"   → 빠른 경량
     - label: "gpt56_sol_xhigh"  → 고강도 추론
     - label: "gpt56_sol_max"    → 최난도 단일 작업
     - label: "gpt56_sol_ultra"  → 최상위 자동 위임 (비중첩 전용)
     - label: "custom"      → 사용자가 관리하는 프로필
   

3. AskUserQuestion으로 effort 선택: low | medium | high | xhigh | max | ultra
4. Edit 도구로 ~/.codex/<선택한 이름>.config.toml 수정

기본 모델 변경

위와 동일한 모델/effort 선택 후 top-level model, model_reasoning_effort 수정.

프로파일 추가/삭제

추가: 이름 → 모델 → effort → ~/.codex/<name>.config.toml 생성 삭제: 선택 → 확인 → 해당 ~/.codex/<name>.config.toml 삭제

Step 4: 결과 확인

변경된 top-level config와 프로파일 파일을 다시 읽어 업데이트된 테이블 표시.

---

Antigravity 워크플로우

Step 1: triflux-profiles.json 읽기 + 현재 상태 표시

~/.gemini/triflux-profiles.json을 Read 도구로 읽고 프로필 테이블을 마크다운으로 출력한다:

| 프로필 | 모델 | 설명 |
|--------|------|------|
| pro31  | profiles.json의 현재 프로필 값 | 플래그십 프로필 |
| flash3 | profiles.json의 현재 프로필 값 | 빠른 응답 프로필 |
| ...    | ...                    | ...                 |

기본 모델(top-level model)도 함께 표시.

Step 2: 작업 선택 (AskUserQuestion)

question: "어떤 작업을 하시겠습니까?"
header: "작업"
options:
  - label: "프로필 모델 변경"
    description: "기존 프로필의 모델을 수정"
  - label: "기본 모델 변경"
    description: "top-level default 모델 수정"
  - label: "프로필 추가"
    description: "새 프로필 생성"
  - label: "프로필 삭제"
    description: "기존 프로필 제거"

Step 3: 선택에 따른 세부 플로우

프로필 모델 변경

1. AskUserQuestion으로 프로필 선택
2. AskUserQuestion으로 프로필 선택:

   options:
     - label: "pro31"   → 플래그십 프로필
     - label: "flash3"  → 빠른 응답 프로필
     - label: "pro25"   → 안정 예비 프로필
     - label: "flash25" → 대량 배치 프로필
     - label: "lite25"  → 최경량 프로필
   

3. Edit 도구로 triflux-profiles.json 수정

기본 모델 변경

모델 선택 후 top-level model 수정.

프로필 추가/삭제

추가: 이름 → 모델 → 설명 → profiles에 추가 삭제: 선택 → 확인 → profiles에서 제거

Step 4: 결과 확인

변경된 JSON을 다시 읽어 업데이트된 테이블 표시.

---

수정 규칙

Codex

• 백업 필수: 수정 전 원본 기억
• 프로파일 파일 형식: ~/.codex/<name>.config.toml 안에 model = "..."와 model_reasoning_effort = "..."를 top-level 키로 기록
• inline 프로파일 금지: config.toml에 [profiles.<name>] 섹션을 추가하지 않기
• 기본값만 config.toml에서 수정: top-level model, model_reasoning_effort 외 [notice], [features], [mcp_servers.*] 등은 건드리지 않기

Antigravity (triflux-profiles.json)

• 백업 필수: .bak 자동 생성
• JSON 형식 유지: profiles.{name}.model, profiles.{name}.hint
• Edit 도구 사용: old_string → new_string으로 해당 프로필만 치환

참조

Codex 프로필

프로필	용도
gpt56_terra_high	기본 고품질
gpt56_sol_xhigh	고강도 추론
gpt56_sol_max	최난도 단일 작업
gpt56_sol_ultra	최상위 자동 위임 (비중첩 전용)
gpt56_terra_med	균형형
gpt56_luna_low	빠른 경량
custom	사용자가 관리하는 프로필

Codex Effort 레벨

레벨	설명
low	빠른 응답, 최소 추론
medium	균형 잡힌 추론
high	깊은 추론
xhigh	고강도 추론
max	최난도 단일 작업용 최대 추론
ultra	최대 추론 + 자동 작업 위임; 팀/스웜 내부 사용 금지

Antigravity 프로필

프로필	용도
pro31	플래그십 프로필
flash3	빠른 응답, 비용 효율 프로필
pro25	안정 예비 프로필
flash25	대량 배치 프로필
lite25	최경량 프로필

Antigravity → 에이전트 배치 (벤치마크 기반)

프로필	용도	에이전트
pro31	플래그십	executor, debugger, deep-executor, architect, planner, critic, analyst, code-reviewer, security-reviewer, quality-reviewer, scientist-deep, designer
flash3	빠른 응답	writer, build-fixer, spark, 기본 폴백
pro25	안정 예비	불안정 시 폴백
flash25	대량 배치	예비
lite25	최경량	예비

설정 파일 경로

• Codex: ~/.codex/config.toml
• Antigravity: ~/.gemini/triflux-profiles.json

에러 처리

상황	처리
config.toml 미존재	/tfx-setup 안내
triflux-profiles.json 미존재	기본값으로 자동 생성
파싱 실패	백업 후 수동 수정 안내
중복 프로파일명	이미 존재함 알림, 기존 편집으로 전환

standalone TUI

터미널에서 직접 실행:

• Codex: node tui/codex-profile.mjs
• Antigravity: node tui/gemini-profile.mjs