설치 · 로그인
OrangeTree를 처음 여는 데 필요한 건 명령어 한 줄과 작업 폴더 하나뿐입니다. 로컬 실행에는 별도 로그인이 필요 없습니다.
설치
터미널에서 전역 설치합니다. Node.js 20 이상이 필요합니다.
$ npm install -g @orangeworks/orangetree
실행
orangetree 를 입력하면 로컬 서버가 뜨고 기본 브라우저에 앱이 열립니다.
$ orangetree
# → http://127.0.0.1:4100 이 자동으로 열립니다작업 폴더 선택
처음 열면 “작업 폴더 설정” 창이 뜹니다. OrangeTree는 여기서 고른 폴더 안에서만 동작하며, 원격 접속 시에도 그 밖은 보이지 않습니다. 폴더를 고르고 “이 폴더로 시작”을 누르세요.
워크벤치 도착
설정을 마치면 작업 화면이 열립니다. 왼쪽은 탐색기, 가운데는 캔버스, 오른쪽은 대화 패널입니다.
계정 연결 (선택)
로컬 사용에는 로그인이 필요 없습니다. 다른 기기에서 원격 접속하거나 클라우드 기능을 쓰려면 오른쪽 위 🔗 배지로 계정을 연결하세요.
프로젝트 생성
프로젝트는 작업의 묶음입니다. 상단 프로젝트 드롭다운에서 새 프로젝트를 만들어 시작합니다.
새 프로젝트 열기
왼쪽 위 프로젝트 드롭다운을 열고 “＋ 새 프로젝트”를 누릅니다.
이름과 봇 선택
프로젝트 이름을 입력하고 실행 봇을 고릅니다. 기본값은 “기본 봇으로 자동변경”(고정하지 않고 기본 봇을 따름)입니다. “생성”을 누르면 프로젝트가 만들어집니다.
첫 대화
주제를 정하지 않고 바로 대화를 시작할 수 있습니다. 첫 메시지를 보내면 그 대화가 하나의 노드가 됩니다.
메시지 보내기
오른쪽 대화 패널 입력창에 요청을 적고 Ctrl/Cmd + Enter 로 보냅니다. 아래에서 모델·노력 강도·권한을 조절할 수 있습니다.
노드가 생겼습니다
가운데 캔버스에 방금 대화가 카드(노드)로 나타납니다. 노드를 클릭하면 그 대화로 돌아가고, 이어서 갈래를 뻗어 나갈 수 있습니다.
노드 · 워크플로우
모든 대화는 캔버스 위의 노드입니다. 작업을 여러 갈래로 나눠 병렬·순차로 실행하고 결과를 다시 모으는 것이 워크플로우입니다.
노드로 생각을 나눈다
하나의 노드에서 다른 방향이 필요하면 새 노드로 분기합니다. 각 노드는 자기 대화·상태를 가지며, 캔버스에서 관계가 한눈에 보입니다.
워크플로우로 자동 실행
여러 하위 작업으로 나눠야 하면 워크플로우를 제안해 승인 한 번으로 팬아웃하고, 병렬·순차 실행과 검증·취합까지 자동으로 잇습니다.