Oxynote는 Prometheus·SQL 지표 차트와 설명 문서를 한 페이지에 배치하고, 변경 사항을 초안·비교·승인 절차로 검토할 수 있는 자체 호스팅 위키다. 개발팀은 내부 서비스 문서와 운영 지표를 함께 관리하려는 기술 인력을 대상으로 한다.

설치와 이용 대상

Oxynote는 컨테이너 하나로 실행할 수 있다. 다음 명령으로 설치한 뒤 http://localhost:8080에 접속해 로그인한다.

docker run -d --name oxynote \\
 -p 8080:8080 \\
 -v oxynote_data:/oxynote/data \\
 ghcr.io/oxynote/oxynote:latest

초기 로그인 계정은 admin@example.com, 비밀번호는 oxynote-admin-1234다. 소스에서 실행하는 방법은 CONTRIBUTING.md에 안내돼 있다.

Live Metrics 블록은 Prometheus 또는 SQL 쿼리로 시계열·막대 차트·게이지를 표시한다. SQL 데이터베이스로는 PostgreSQL, MySQL, MariaDB를 지원한다. 여러 블록을 나란히 배치해 지표 그리드를 만들고, 차트의 의미와 임계값, 대응 방법을 같은 페이지에 적을 수 있다.

페이지를 검토 대상으로 설정하면 변경 사항은 초안에 반영된다. 비교 화면은 문장뿐 아니라 블록 단위 변경도 보여주며, 검토자가 승인하면 초안이 기본 브랜치에 병합된다. 기본 브랜치를 보호해 직접 편집을 막는 설정도 제공한다.

페이지 공동 편집과 댓글 기능도 포함한다. 편집 중인 사람과 위치를 확인할 수 있고, 댓글은 단어·다이어그램의 특정 줄·차트에 연결할 수 있다. 그 밖에 하위 페이지와 태그, 전체 텍스트 검색, GitHub 파일·컨테이너 이미지·웹페이지·날짜 변경을 추적하는 알림 기능을 제공한다.

내장 도우미 Rubber Duck은 페이지 편집과 블록에서 사용하는 쿼리 실행을 지원한다. Anthropic, OpenAI, Google, OpenRouter 모델이나 Ollama를 통한 로컬 모델을 선택할 수 있으며, Claude Code와 Codex 같은 MCP 클라이언트도 OAuth를 통해 같은 도구를 사용할 수 있다고 제작진은 설명한다.

현재 호스팅 서비스는 없으며, 제작진은 로그와 알림 기능도 아직 제공하지 않는다고 밝혔다. 제품은 회사 전체를 위한 범용 위키보다는 기술팀과 이들이 운영하는 시스템을 위한 도구로 소개됐다. 자세한 내용과 소스 코드는 Oxynote 저장소에서 확인할 수 있다.