revka agent

revka agent는 터미널에서 에이전트 루프를 시작합니다. 인수 없이 실행하면 설정된 프로바이더와 모델을 대상으로 대화형 채팅 세션이 열리고, -m을 사용하면 단일 쿼리를 실행한 뒤 응답을 출력하고 종료합니다. 어느 방식이든 에이전트는 전체 도구 세트, 메모리, 스킬에 접근할 수 있습니다.

이 명령어는 에이전트와 로컬에서 대화하거나, 파이프라인에서 일회성 쿼리를 스크립트로 실행하거나, config.toml을 수정하지 않고 프로바이더·모델·온도 조합을 테스트할 때 사용합니다. 대시보드와 채널을 함께 제공하는 상시 가동 에이전트가 필요하다면 revka gateway, daemon & service를 참조하십시오.

각 턴 내부에서 일어나는 동작에 대한 배경 지식은 에이전트 루프를, 대화 상태가 유지되는 방식은 세션 및 대화 상태를 참조하십시오.

개요

revka agent [-m <TEXT>] [--session-state-file <PATH>] \
            [-p <ID>] [--model <MODEL_ID>] [-t <TEMP>] \
            [--peripheral <board:path>]...

revka agent                                                   # interactive session
revka agent -m "Summarize today's logs"                       # single message
revka agent --provider anthropic --model claude-sonnet-4-20250514
revka agent -p openrouter --model openai/gpt-4o --temperature 0.3
revka agent --session-state-file session.json                 # load/save state

플래그

플래그	축약	값	설명
--message	-m	<TEXT>	단일 메시지 모드: 쿼리 하나를 실행하고 응답을 출력한 뒤, 대화형 루프에 진입하지 않고 종료합니다.
--session-state-file		<PATH>	실행 간에 대화형 세션 상태를 유지·복원하는 데 사용할 JSON 파일입니다.
--provider	-p	<ID>	이번 실행에서 설정된 기본 프로바이더를 재정의합니다 (예: anthropic, openrouter, openai, openai-codex).
--model		<MODEL_ID>	이번 실행에서 설정된 기본 모델을 재정의합니다.
--temperature	-t	0.0–2.0	이번 실행에서 설정된 샘플링 온도를 재정의합니다.
--peripheral		<board:path>	CLI에서 허용되고 값이 로깅되지만, 에이전트에 아직 연결되지 않았습니다 — 세션에 장치를 연결하지 않습니다. 반복 사용 가능합니다.

참고

--model과 --peripheral에는 축약형이 없습니다. 축약 플래그는 -m (메시지), -p (프로바이더), -t (온도)입니다.

대화형 vs 단발성

대화형 세션

revka agent를 -m 없이 실행하면 지속적인 채팅 루프가 열립니다. 에이전트는 세션 내 턴 간에 대화 기록을 유지하므로 후속 질문에서도 문맥이 유지됩니다.

revka agent

루프 안에서 자연어 메시지를 입력하거나 아래 내장 명령어를 사용할 수 있습니다.

명령어	동작
/help	사용 가능한 채팅 내 명령어를 표시합니다.
/clear 또는 /new	대화 기록을 초기화합니다. 확인 후 대화 및 일일 메모리를 삭제하며, 장기 핵심 메모리는 보존됩니다.
/quit 또는 /exit	대화형 모드를 종료합니다.
/think:<level>	다음 턴의 추론 깊이를 설정합니다. 레벨: off, minimal, low, medium, high, max.

대화형 프롬프트는 자연어 라우팅 지시도 이해합니다. 예: “conversation uses kimi, coding uses gpt-5.3-codex”.

주의

에이전트 모드에서는 설정 핫 리로드가 지원되지 않습니다. 대화형 세션이 열린 상태에서 config.toml을 변경한 경우, 새 설정을 적용하려면 revka agent를 재시작해야 합니다. (핫 리로드는 장시간 실행되는 데몬 및 채널에는 적용됩니다.)

단발성 쿼리

-m/--message를 전달하면 쿼리 하나만 실행합니다. 에이전트는 최종 응답을 stdout에 출력하고 종료하므로, 스크립트·크론 잡·CI에서 사용하기 편리합니다.

revka agent -m "Summarize today's logs"

출력이 stdout으로 전달되므로 캡처하거나 파이프로 연결할 수 있습니다.

SUMMARY="$(revka agent -m 'One-line status of the build')"

단발성 모드에서는 대화형 세션 상태 파일을 읽거나 쓰지 않으며, 일회성 턴으로 실행됩니다.

프로바이더·모델·온도 재정의

세 가지 재정의 플래그를 사용하면 config.toml을 변경하지 않고 단일 실행에서 다른 백엔드를 시도할 수 있습니다. 각 플래그는 해당 호출에서 대응하는 설정 기본값만 재정의합니다.

# Use Anthropic + a specific model for this run only
revka agent --provider anthropic --model claude-sonnet-4-20250514

# Route through OpenRouter to a model id, with a lower temperature
revka agent -p openrouter --model openai/gpt-4o --temperature 0.3

• -p/--provider는 default_provider를 재정의합니다.
• --model은 default_model을 재정의합니다.
• -t/--temperature는 default_temperature를 재정의합니다.

플래그를 생략하면 config.toml의 값이 사용됩니다.

주의

--temperature는 0.0 이상 2.0 이하 범위의 부동소수점으로 파싱되어야 합니다. 범위를 벗어난 값이나 숫자가 아닌 값은 세션 시작 전에 거부되며, temperature 3 is out of range (expected 0..=2)와 같은 오류가 출력됩니다.

동일한 재정의를 환경 변수로도 지정할 수 있어 컨테이너와 CI 환경에서 편리합니다. 이 변수들은 프로세스 전체에서 대응하는 config.toml 키를 덮어씁니다.

REVKA_PROVIDER=anthropic \
REVKA_MODEL=claude-sonnet-4-20250514 \
REVKA_TEMPERATURE=0.3 \
revka agent -m "hello"

변수	재정의 대상
REVKA_PROVIDER	default_provider
REVKA_MODEL / MODEL	default_model
REVKA_TEMPERATURE	default_temperature
REVKA_API_KEY / API_KEY	api_key

전체 프로바이더 카탈로그 및 커스텀·로컬 엔드포인트 등록 방법은 커스텀 프로바이더 및 로컬 LLM과 revka models, providers & auth를 참조하십시오.

세션 상태 파일 (--session-state-file)

--session-state-file <PATH>는 대화형 루프가 대화를 유지·복원하는 데 사용할 JSON 파일을 지정합니다.

revka agent --session-state-file session.json

• 시작 시, 파일이 존재하면 이전 대화 기록을 불러와 중단한 지점부터 재개합니다. 파일이 없으면 새 세션으로 시작합니다.
• 각 턴 후, 업데이트된 기록이 파일에 다시 기록됩니다.
• /new 또는 /clear 실행 시, 초기화된 상태도 파일에 저장됩니다.

이 경로는 안정적인 세션 식별자를 파생하는 데도 사용되므로, 해당 세션에 연결된 메모리가 저장된 기록과 일치합니다. 서로 다른 파일을 각각의 진행 중인 대화에 지정하면 대화를 분리하여 관리할 수 있습니다.

# Resume an ops conversation, separate from a research one
revka agent --session-state-file ~/.revka/sessions/ops.json
revka agent --session-state-file ~/.revka/sessions/research.json

참고

세션 상태 파일은 대화형 모드 기능입니다. 대화형 세션을 실행할 때만 읽고 쓰며, 단발성(-m) 모드에서는 사용되지 않습니다.

Revka가 대화를 추적하는 방식에 대한 전반적인 모델은 세션 및 대화 상태를 참조하십시오.

--peripheral 플래그 (아직 연결되지 않음)

--peripheral <board:path>는 CLI에서 허용되고 값이 로깅되지만, 에이전트에 아직 연결되지 않았습니다 — 이 플래그를 전달해도 장치가 연결되거나 세션에 하드웨어 도구 호출이 노출되지 않습니다. 에이전트의 주변 장치 도구는 config.toml의 [peripherals] 섹션에서만 빌드됩니다.

에이전트에서 주변 장치를 사용하려면 revka peripheral add를 통해 영구적으로 등록하거나 config.toml을 직접 편집하십시오. 전체 보드 목록, 플래싱, 영구 등록에 대한 내용은 revka hardware & peripheral을 참조하십시오.

예제

# Interactive session on your configured defaults
revka agent

# One-off summary, captured into a variable
NOTES="$(revka agent -m 'Summarize the last hour of audit events')"

# Try a different provider/model/temperature for one run
revka agent -p anthropic --model claude-sonnet-4-20250514 -t 0.2

# Resume a named, persisted conversation
revka agent --session-state-file ~/.revka/sessions/daily.json

관련 페이지

• 에이전트 루프 — 각 턴 내부에서 일어나는 동작.
• 세션 및 대화 상태 — 대화가 추적되고 재개되는 방식.
• 에이전트와 대화하기 — 에이전트와 대화하는 엔드투엔드 가이드.
• 커스텀 프로바이더 및 로컬 LLM — 재정의 플래그를 위한 프로바이더·모델 설정.
• revka models, providers & auth — 모델 카탈로그 및 프로바이더 인증 관리.
• revka gateway, daemon & service — 대시보드와 채널을 포함한 상시 가동 에이전트 실행.
• revka hardware & peripheral — 주변 장치 등록, 플래싱, 설정.
• CLI 개요 및 환경 — 전역 플래그 및 환경 변수.