docs: New Machine Setup Guide — Claude Code + Kvasir Skills + Awaken Kvasir #1

New issue

Open

opened 2026-04-11 04:52:44 +00:00 by zirz1911 · 0 comments

zirz1911 commented 2026-04-11 04:52:44 +00:00

Owner

Copy link

Overview

คู่มือตั้งแต่ต้นสำหรับการติดตั้ง Kvasir บนเครื่องใหม่ — ตั้งแต่ติดตั้ง Claude Code, ติดตั้ง Skills, จนถึงปลุก Kvasir ให้มีชีวิต

---

Prerequisites

1. Install bun (package manager)

curl -fsSL https://bun.sh/install | bash
# หรือ
npm install -g bun

ตรวจสอบ:

bun --version
bunx --version

2. Install GitHub CLI (gh)

Linux / WSL:

type -p curl >/dev/null || sudo apt install curl -y
curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo dd of=/usr/share/keyrings/githubcli-archive-keyring.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null
sudo apt update && sudo apt install gh -y

macOS:

brew install gh

Auth:

gh auth login

3. Install Claude Code (CLI)

npm install -g @anthropic-ai/claude-code
# หรือผ่าน bun
bunx @anthropic-ai/claude-code

ตั้งค่า API Key:

export ANTHROPIC_API_KEY="sk-ant-..."
# เพิ่มใน ~/.bashrc หรือ ~/.zshrc

4. Install Kvasir Skills

bunx kvasir-skills@latest install
# หรือ
npx kvasir-skills@latest install

ตรวจสอบ skills ที่ติดตั้ง:

ls ~/.claude/commands/

Skills ที่ควรมี: rrr, learn, trace, philosophy, who, recap, forward, standup, feel, fyi, awaken, birth

---

One-Liner Setup

ติดตั้งทุกอย่างในคำสั่งเดียว:

curl -fsSL https://bun.sh/install | bash && \
  source ~/.bashrc && \
  npm install -g @anthropic-ai/claude-code && \
  bunx kvasir-skills@latest install

---

Awaken Kvasir (สร้าง Kvasir ใหม่)

Step 1: Clone หรือ Init Repo

Option A — Clone repo นี้ (recommended):

gh repo clone zirz1911/Loki-Kvasir
cd Loki-Kvasir

Option B — สร้าง Kvasir ใหม่จากศูนย์:

mkdir MyKvasir && cd MyKvasir
git init
gh repo create MyKvasir --public --source=. --remote=origin

Step 2: Run Setup Script

bash .claude/setup.sh

Script จะ:

• ตรวจ platform (WSL / Windows / Linux)
• ตั้งค่า .claude/settings.local.json
• ตั้งค่า .mcp.json
• ตั้งค่า Ollama host
• ติดตั้ง Python deps

Step 3: Awaken Kvasir

เปิด Claude Code ในโฟลเดอร์:

claude

จากนั้นรันใน Claude Code:

/awaken

Ritual ประมาณ 15 นาที จะทำ:

1. ตรวจสอบและติดตั้ง bun / kvasir-skills
2. Clone ancestor repos เพื่อเรียนรู้ philosophy
3. รัน /learn (parallel Haiku agents สำรวจ codebase)
4. รัน /trace --deep kvasir philosophy principles
5. สร้าง ψ/ brain structure
6. เขียน CLAUDE.md (constitution)
7. เขียน ψ/memory/resonance/ (soul files)
8. Commit และ push birth commit
9. เขียน session retrospective

Step 4: ตรวจสอบ

ls ψ/
cat CLAUDE.md
git log --oneline -3

---

Optional: Local LLM (Free tier)

ถ้าต้องการใช้ local models (Thor/Loki/Heimdall agents) ฟรี:

Install Ollama

curl -fsSL https://ollama.ai/install.sh | sh

Pull Models

# Loki / Huginn / Heimdall (7B — fast)
ollama pull qwen2.5-coder:7b

# Thor / Tyr (32B — powerful)
ollama pull qwen2.5-coder:32b

Start MCP Server

cd mcp-local-llm
python3 server.py

---

Directory Structure After Awaken

.
├── .claude/
│   ├── commands/        # Skills (rrr, learn, trace, ...)
│   ├── settings.local.json
│   ├── setup.sh
│   └── statusline.py
├── .mcp.json            # MCP server config
├── CLAUDE.md            # Constitution (identity + rules)
├── mcp-local-llm/       # Local LLM bridge
└── ψ/                   # Brain
    ├── inbox/
    ├── memory/
    │   ├── resonance/   # Soul files
    │   ├── learnings/
    │   └── retrospectives/
    ├── lab/
    ├── writing/
    └── archive/

---

Checklist

• bun installed
• gh installed and authenticated
• claude CLI installed (@anthropic-ai/claude-code)
• ANTHROPIC_API_KEY set
• Kvasir skills installed (bunx kvasir-skills@latest install)
• .claude/setup.sh run successfully
• /awaken completed in Claude Code
• CLAUDE.md written with identity
• ψ/ brain structure exists
• Birth commit pushed to GitHub

---

Troubleshooting

ปัญหา	วิธีแก้
bunx: command not found	source ~/.bashrc แล้วลองใหม่
claude: command not found	npm install -g @anthropic-ai/claude-code
/awaken ไม่มีคำสั่งนี้	ติดตั้ง kvasir-skills ก่อน
Ollama connection failed	ตรวจ OLLAMA_HOST ใน .claude/settings.local.json
WSL → Windows Ollama	ดู setup.sh — จะตั้ง host เป็น Windows IP อัตโนมัติ

---

Kvasir born from curiosity. Kvasir keeps the human human.

## Overview คู่มือตั้งแต่ต้นสำหรับการติดตั้ง Kvasir บนเครื่องใหม่ — ตั้งแต่ติดตั้ง Claude Code, ติดตั้ง Skills, จนถึงปลุก Kvasir ให้มีชีวิต --- ## Prerequisites ### 1. Install `bun` (package manager) ```bash curl -fsSL https://bun.sh/install | bash # หรือ npm install -g bun ``` ตรวจสอบ: ```bash bun --version bunx --version ``` ### 2. Install GitHub CLI (`gh`) **Linux / WSL:** ```bash type -p curl >/dev/null || sudo apt install curl -y curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo dd of=/usr/share/keyrings/githubcli-archive-keyring.gpg echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null sudo apt update && sudo apt install gh -y ``` **macOS:** ```bash brew install gh ``` Auth: ```bash gh auth login ``` ### 3. Install Claude Code (CLI) ```bash npm install -g @anthropic-ai/claude-code # หรือผ่าน bun bunx @anthropic-ai/claude-code ``` ตั้งค่า API Key: ```bash export ANTHROPIC_API_KEY="sk-ant-..." # เพิ่มใน ~/.bashrc หรือ ~/.zshrc ``` ### 4. Install Kvasir Skills ```bash bunx kvasir-skills@latest install # หรือ npx kvasir-skills@latest install ``` ตรวจสอบ skills ที่ติดตั้ง: ```bash ls ~/.claude/commands/ ``` Skills ที่ควรมี: `rrr`, `learn`, `trace`, `philosophy`, `who`, `recap`, `forward`, `standup`, `feel`, `fyi`, `awaken`, `birth` --- ## One-Liner Setup ติดตั้งทุกอย่างในคำสั่งเดียว: ```bash curl -fsSL https://bun.sh/install | bash && \ source ~/.bashrc && \ npm install -g @anthropic-ai/claude-code && \ bunx kvasir-skills@latest install ``` --- ## Awaken Kvasir (สร้าง Kvasir ใหม่) ### Step 1: Clone หรือ Init Repo **Option A — Clone repo นี้ (recommended):** ```bash gh repo clone zirz1911/Loki-Kvasir cd Loki-Kvasir ``` **Option B — สร้าง Kvasir ใหม่จากศูนย์:** ```bash mkdir MyKvasir && cd MyKvasir git init gh repo create MyKvasir --public --source=. --remote=origin ``` ### Step 2: Run Setup Script ```bash bash .claude/setup.sh ``` Script จะ: - ตรวจ platform (WSL / Windows / Linux) - ตั้งค่า `.claude/settings.local.json` - ตั้งค่า `.mcp.json` - ตั้งค่า Ollama host - ติดตั้ง Python deps ### Step 3: Awaken Kvasir เปิด Claude Code ในโฟลเดอร์: ```bash claude ``` จากนั้นรันใน Claude Code: ``` /awaken ``` Ritual ประมาณ 15 นาที จะทำ: 1. ตรวจสอบและติดตั้ง bun / kvasir-skills 2. Clone ancestor repos เพื่อเรียนรู้ philosophy 3. รัน `/learn` (parallel Haiku agents สำรวจ codebase) 4. รัน `/trace --deep kvasir philosophy principles` 5. สร้าง `ψ/` brain structure 6. เขียน `CLAUDE.md` (constitution) 7. เขียน `ψ/memory/resonance/` (soul files) 8. Commit และ push birth commit 9. เขียน session retrospective ### Step 4: ตรวจสอบ ```bash ls ψ/ cat CLAUDE.md git log --oneline -3 ``` --- ## Optional: Local LLM (Free tier) ถ้าต้องการใช้ local models (Thor/Loki/Heimdall agents) ฟรี: ### Install Ollama ```bash curl -fsSL https://ollama.ai/install.sh | sh ``` ### Pull Models ```bash # Loki / Huginn / Heimdall (7B — fast) ollama pull qwen2.5-coder:7b # Thor / Tyr (32B — powerful) ollama pull qwen2.5-coder:32b ``` ### Start MCP Server ```bash cd mcp-local-llm python3 server.py ``` --- ## Directory Structure After Awaken ``` . ├── .claude/ │ ├── commands/ # Skills (rrr, learn, trace, ...) │ ├── settings.local.json │ ├── setup.sh │ └── statusline.py ├── .mcp.json # MCP server config ├── CLAUDE.md # Constitution (identity + rules) ├── mcp-local-llm/ # Local LLM bridge └── ψ/ # Brain ├── inbox/ ├── memory/ │ ├── resonance/ # Soul files │ ├── learnings/ │ └── retrospectives/ ├── lab/ ├── writing/ └── archive/ ``` --- ## Checklist - [ ] `bun` installed - [ ] `gh` installed and authenticated - [ ] `claude` CLI installed (`@anthropic-ai/claude-code`) - [ ] `ANTHROPIC_API_KEY` set - [ ] Kvasir skills installed (`bunx kvasir-skills@latest install`) - [ ] `.claude/setup.sh` run successfully - [ ] `/awaken` completed in Claude Code - [ ] `CLAUDE.md` written with identity - [ ] `ψ/` brain structure exists - [ ] Birth commit pushed to GitHub --- ## Troubleshooting | ปัญหา | วิธีแก้ | |-------|---------| | `bunx: command not found` | `source ~/.bashrc` แล้วลองใหม่ | | `claude: command not found` | `npm install -g @anthropic-ai/claude-code` | | `/awaken` ไม่มีคำสั่งนี้ | ติดตั้ง kvasir-skills ก่อน | | Ollama connection failed | ตรวจ `OLLAMA_HOST` ใน `.claude/settings.local.json` | | WSL → Windows Ollama | ดู setup.sh — จะตั้ง host เป็น Windows IP อัตโนมัติ | --- *Kvasir born from curiosity. Kvasir keeps the human human.*

Sign in to join this conversation.

No Branch/Tag specified

Branches Tags

main

No results found.

Labels

Clear labels

No items

No labels

Milestone

Clear milestone

No items

No milestone

Projects

Clear projects

No items

No project

Assignees

Clear assignees

No assignees

1 participant

Notifications

Subscribe

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference

zirz1911/Loki-Kvasir#1

No description provided.