入手する

Get it

3つのリンクで動かせる。

Up and running in three links.

Noa は macOS で動きます。基本は Node.js とこのリポジトリだけ。ただし Noa の中で Claude Code を使うには、別途 Claude Code 本体のインストールとログインが必要です（下記セットアップの事前準備を参照）。

Noa runs on macOS. All you really need is Node.js and this repository. To use Claude Code inside Noa, however, you'll need to install and log in to Claude Code separately (see the prerequisites in the setup section below).

STEP 1

Node.js をインストール

まだ入っていない場合は公式サイトから LTS 版をダウンロード。

nodejs.org をひらく ↗

STEP 1

Install Node.js

If you don't have it yet, download the LTS version from the official site.

Open nodejs.org ↗

STEP 2

Noa を GitHub から取得

ターミナルに貼り付けて Enter。

        クリックでコピー

        git clone https://github.com/kinoshitastudio/noa.git

        cd noa && npm install && npm start

STEP 2

Get Noa from GitHub

Paste it into your terminal and hit Enter.

        Click to copy

        git clone https://github.com/kinoshitastudio/noa.git

        cd noa && npm install && npm start

STEP 3（推奨）

Tailscale で iPhone からも

外出先の iPhone からも使いたい場合は Tailscale を Mac と iPhone 両方に入れる。

Tailscale をダウンロード ↗

STEP 3 (recommended)

Add Tailscale for iPhone access

If you want to use it from your iPhone while out, install Tailscale on both your Mac and iPhone.

Download Tailscale ↗

詳しいセットアップ手順はセットアップセクションを参照。ソースコードは GitHub（MIT License）で公開中。

For detailed instructions, see the setup section. The source code is available on GitHub (MIT License).

これは何か

What is it

自分のMacに、いつでも入れる。

Your own Mac, accessible anytime.

Noa は Node.js で動く Web サーバー。起動すれば、同じネットワーク内の任意のデバイスのブラウザからターミナルに接続できる。Tailscale と組み合わせれば、外出中の iPhone からでも自宅 Mac の Claude Code や開発サーバーを操作できる。

Noa is a web server that runs on Node.js. Once it's up, you can connect to its terminal from a browser on any device on the same network. Combine it with Tailscale and you can drive your home Mac's Claude Code or dev server from your iPhone while you're out.

プロジェクトごとに独立した PTY セッションを持てるので、BMBoard の作業と Atelier の作業を並行して走らせながら、どちらのターミナルも同時に見られる。

Each project gets its own independent PTY session, so you can run your BMBoard work and your Atelier work in parallel and watch both terminals at the same time.

機能

Features

プロダクトで使う機能、全部入り。

Everything you need, built in.

プロジェクト別 PTY セッション

タブごとに独立した端末セッション。複数プロダクトを同時進行できる。

Per-project PTY sessions

Each tab is an independent terminal session, so you can work on multiple products at once.

3カラムレイアウト

TERM | EDITOR | FILES+PREVIEW の3ペイン。ファイル閲覧・編集・端末を同時に表示。

Three-column layout

A TERM | EDITOR | FILES+PREVIEW three-pane view. Browse files, edit, and use the terminal all at once.

モバイルファースト

iPhone からそのままタップ操作。ソフトキーボード対応。外出先から Claude Code を動かせる。

Mobile-first

Tap to operate it straight from your iPhone, with soft-keyboard support. Run Claude Code on the go.

Tailscale 対応

Mac を常時起動・Tailscale 接続しておけば、どこからでも同じ URL でアクセス可能。

Tailscale ready

Keep your Mac always on and connected to Tailscale, and reach it from anywhere via the same URL.

セッション共有

同じ Noa サーバーへの接続は PTY を共有。PC で進めた作業をモバイルで確認できる。

Shared sessions

Connections to the same Noa server share the PTY, so you can pick up work from your PC on mobile.

4テーマ

Dark / Light / Game Boy / Paper。気分や場所に合わせて切り替え可能。

Four themes

Dark / Light / Game Boy / Paper. Switch to match your mood or your surroundings.

セットアップ

Setup

Mac に入れる。ブラウザで開く。それだけ。

Install on your Mac. Open in a browser. That's it.

Noa は Mac 上で動く小さなサーバーです。起動すると、Safari や Chrome などのブラウザからターミナルを操作できるようになります。インストールはターミナルに4行貼り付けるだけです。

Noa is a small server that runs on your Mac. Once it's running, you can operate its terminal from a browser like Safari or Chrome. Installing it is just a matter of pasting four lines into your terminal.

事前準備（はじめに一度だけ）

① macOS が必要
Noa は Mac 上で動きます（Linux でもおおむね動作しますが、Windows は非対応）。

② Node.js（v18 以上）
Noa を動かす土台です。nodejs.org から「LTS（推奨版）」を入れてください。確認：node -v で数字が出れば OK（例: v20.11.0）。

③ Xcode Command Line Tools
Noa が使う node-pty のビルドに必要です（無いと npm install がエラーになります）。ターミナルで一度だけ：

xcode-select --install

すでに入っていれば「インストール済み」と表示されます。

④ Claude Code（Noa の中で Claude を使う場合）
Noa はプロジェクトを開くと自動で claude を起動します。未インストールだと command not found: claude になります。先に入れておきましょう：

npm install -g @anthropic-ai/claude-code

インストール後、一度 claude を実行するとブラウザが開いてログインできます（Claude の Pro / Max サブスク、または API キーが必要）。くわしくは claude.com/claude-code ↗。

Prerequisites (one-time setup)

1. macOS required
Noa runs on a Mac (it mostly works on Linux too, but Windows is not supported).

2. Node.js (v18 or later)
This is the foundation Noa runs on. Install the "LTS (recommended)" build from nodejs.org. To check: if node -v prints a number, you're good (e.g. v20.11.0).

3. Xcode Command Line Tools
Required to build node-pty, which Noa uses (without it, npm install will fail). Run this once in your terminal:

xcode-select --install

If it's already installed, you'll see a message saying so.

4. Claude Code (if you want to use Claude inside Noa)
When you open a project, Noa automatically launches claude. If it isn't installed, you'll get command not found: claude. Install it first:

npm install -g @anthropic-ai/claude-code

After installing, run claude once and a browser will open so you can log in (a Claude Pro / Max subscription or an API key is required). Learn more at claude.com/claude-code ↗.

STEP 01

Noa をダウンロードする

Mac のターミナル（アプリ一覧 → ターミナル.app）を開き、以下をコピペして Enter。

git clone https://github.com/kinoshitastudio/noa.git
cd noa

これで「noa」というフォルダが手元に作られます。

STEP 01

Download Noa

Open Terminal on your Mac (app list → Terminal.app), then copy and paste the following and hit Enter.

git clone https://github.com/kinoshitastudio/noa.git
cd noa

This creates a folder called "noa" on your machine.

STEP 02

インストールして起動する

続けて以下を貼り付けます。

npm install
npm start

Server running on http://localhost:2797 と表示されたら起動完了です。このターミナルは閉じないでください（閉じると Noa も止まります）。

ターミナルって何？ Mac に最初から入っているアプリです。 Finder → アプリケーション → ユーティリティ → ターミナル.app で開けます。

トークンを固定したい場合 Noa は既定では起動のたびに新しいトークンを生成するため、アクセス URL のトークンが毎回変わります。固定したいときは環境変数を指定して起動してください：

NOA_TOKEN=yourtoken npm start

こうすると、アクセス URL のトークンが一定になります（例: http://localhost:2797/?token=yourtoken）。

STEP 02

Install and start it

Next, paste the following.

npm install
npm start

When you see Server running on http://localhost:2797, it's up and running. Leave this terminal open (closing it stops Noa).

What's a terminal? It's an app that comes built into your Mac. Open it via Finder → Applications → Utilities → Terminal.app.

If you want a fixed token By default Noa generates a new token on every launch, so the token in the access URL changes each time. To keep it fixed, start Noa with an environment variable:

NOA_TOKEN=yourtoken npm start

This keeps the token in the access URL constant (e.g. http://localhost:2797/?token=yourtoken).

STEP 03

ブラウザで開く

Safari や Chrome を開き、アドレスバーに以下を入力します。

http://localhost:2797

下のような3カラムの画面が表示されれば完成です。左がターミナル、真ん中がエディター、右がファイルツリーです。

▶ main BMBoard Atelier

TERM

~/projects $ ls

black_mirror/ atelier/

~/projects $

EDITOR

index.html

<!DOCTYPE html>

<head>

FILES

📁 projects/

📁 black_mirror/

📁 atelier/

📄 README.md

STEP 03

Open it in a browser

Open Safari or Chrome and type the following into the address bar.

http://localhost:2797

You're done once a three-column screen like the one below appears. Terminal on the left, editor in the middle, file tree on the right.

▶ main BMBoard Atelier

TERM

~/projects $ ls

black_mirror/ atelier/

~/projects $

EDITOR

index.html

<!DOCTYPE html>

<head>

FILES

📁 projects/

📁 black_mirror/

📁 atelier/

📄 README.md

STEP 04（推奨）

iPhone やどこからでも使えるようにする

STEP 03 までの状態では、同じ Wi-Fi に繋がっているデバイスからしかアクセスできません。外出先や iPhone のモバイル回線からも使えるようにするには、 Tailscale（無料）を使います。

Tailscale とは？ Mac と iPhone を「仮想的に同じネットワーク」に置くツールです。 VPN の一種で、設定は Mac と iPhone 両方にアプリを入れてサインインするだけ。難しい設定は不要です。

インストール後、Mac の Tailscale IP アドレス（例: 100.x.x.x）を確認し、iPhone の Safari で開きます。

Tailscale IP は、メニューバーの Tailscale アプリのアイコンをクリックして確認できます。もしくはターミナルで次のコマンドを実行します：

# Mac の Tailscale IP（100.x.x.x）を表示
tailscale ip -4

# iPhone の Safari でアクセス（IPは自分のものに置き換え）
http://100.x.x.x:2797

PC で進めていた作業の続きを、外出先の iPhone からそのまま操作できます。同じターミナルセッションを共有しているので、どちらで操作しても内容は同期されます。

# Mac をスリープさせない設定（外出中も接続を維持するため）
sudo pmset -a sleep 0 displaysleep 10

STEP 04 (recommended)

Make it accessible from your iPhone and anywhere

Up through STEP 03, you can only reach it from devices on the same Wi-Fi. To use it on the go or over your iPhone's cellular connection, use Tailscale (free).

What is Tailscale? It's a tool that puts your Mac and iPhone on the same "virtual network." It's a kind of VPN—setup is just installing the app on both your Mac and iPhone and signing in. No complicated configuration required.

After installing, find your Mac's Tailscale IP address (e.g. 100.x.x.x) and open it in Safari on your iPhone.

You can find the Tailscale IP by clicking the Tailscale app icon in the menu bar. Or run the following command in your terminal:

# Show your Mac's Tailscale IP (100.x.x.x)
tailscale ip -4

# Open in Safari on iPhone (replace the IP with your own)
http://100.x.x.x:2797

You can pick up the work you were doing on your PC right from your iPhone while out. Since they share the same terminal session, anything you do on either stays in sync.

# Keep the Mac from sleeping (to stay reachable while away)
sudo pmset -a sleep 0 displaysleep 10

どこからアクセスできる？

Where can you access it?

場所によって URL が変わるだけ。

Only the URL changes by location.

Noa 自体の使い方は同じ。アクセスする URL だけが変わります。

Noa works the same way everywhere. Only the URL you connect to changes.

Mac のブラウザから（同じ PC）

Noa を起動した Mac 上の Safari / Chrome から開く場合。

http://localhost:2797

From the Mac's browser (same PC)

When opening it from Safari / Chrome on the Mac running Noa.

http://localhost:2797

同じ Wi-Fi 上の別デバイスから

家の iPad やサブ PC など、同じルーターに繋がっている場合。Mac のローカル IP を使う。

http://192.168.x.x:2797

From another device on the same Wi-Fi

For a home iPad, a second PC, etc. on the same router. Use the Mac's local IP.

http://192.168.x.x:2797

外出先の iPhone から（Tailscale）

モバイル回線でも Tailscale を使えば同じように接続できる。

http://100.x.x.x:2797

From your iPhone on the go (Tailscale)

Even over cellular, you can connect the same way using Tailscale.

http://100.x.x.x:2797

どの場合も画面は同じ

URL が違うだけで、表示される Noa の画面・ターミナルセッションはすべて共通です。PC で打ったコマンドの続きを iPhone で確認できます。

The screen is the same in every case

Only the URL differs—the Noa screen and terminal session shown are all shared. You can check on commands you typed on your PC from your iPhone.

よくある質問

FAQ

わからなかったら読む。

Read this if you get stuck.

Windows でも使えますか？

現在は Mac 専用です。Linux でも動作しますが、Windows はサポート外です。

Can I use it on Windows?

Right now it's Mac-only. It also runs on Linux, but Windows is not supported.

「npm install」のあとにエラーが出ます

主な原因は2つです。
①Node.js が古い：node -v で確認し、v18 未満なら nodejs.org から最新版を。
②Xcode Command Line Tools が無い：Noa は node-pty をビルドするため必要です。xcode-select --install を実行してから、もう一度 npm install してください。

I get an error after "npm install"

There are two common causes.
1. Node.js is outdated: check with node -v; if it's below v18, get the latest version from nodejs.org.
2. Xcode Command Line Tools are missing: Noa needs them to build node-pty. Run xcode-select --install, then try npm install again.

ターミナルに「command not found: claude」と出ます

Noa はプロジェクトを開くと Claude Code 本体（claude コマンド）を起動しますが、これは Noa とは別にインストールが必要です。npm install -g @anthropic-ai/claude-code を実行し、続けて claude でログイン（Claude の Pro / Max サブスク or API キーが必要）してください。詳細は claude.com/claude-code。

The terminal says "command not found: claude"

When you open a project, Noa launches Claude Code itself (the claude command), which has to be installed separately from Noa. Run npm install -g @anthropic-ai/claude-code, then log in with claude (a Claude Pro / Max subscription or an API key is required). For details, see claude.com/claude-code.

Mac をシャットダウンすると使えなくなりますか？

はい。Noa は Mac 上で動いているサーバーなので、Mac が起動していないと接続できません。外出中も使いたい場合は、Mac をスリープさせない設定（STEP 04 の pmset コマンド）を適用してください。

Does it stop working if I shut down the Mac?

Yes. Noa is a server running on your Mac, so you can't connect unless the Mac is on. If you want to use it while out, apply the setting that keeps the Mac from sleeping (the pmset command in STEP 04).

ターミナルを閉じたら Noa も止まりますか？

はい。npm start を実行したターミナルを閉じると Noa も停止します。常時起動したい場合は pm2 などのプロセスマネージャを使うと便利です。

Does closing the terminal stop Noa?

Yes. Closing the terminal where you ran npm start stops Noa too. If you want it running all the time, a process manager like pm2 is handy.

セキュリティは大丈夫ですか？

起動時にトークン認証が必要です。デフォルトは NOA_TOKEN=dev ですが、外部公開する場合は必ず変更してください。Tailscale を使えばプライベートネットワーク内のみのアクセスに限定できます。

Is it secure?

Token authentication is required at startup. The default is NOA_TOKEN=dev, but be sure to change it if you expose it externally. With Tailscale, you can limit access to within your private network only.

ブラウザで動く、
あなただけの端末。

Your own terminal,
running in a browser.

3つのリンクで動かせる。

Up and running in three links.

自分のMacに、いつでも入れる。

Your own Mac, accessible anytime.

プロダクトで使う機能、全部入り。

Everything you need, built in.

Mac に入れる。ブラウザで開く。それだけ。

Install on your Mac. Open in a browser. That's it.

場所によって URL が変わるだけ。

Only the URL changes by location.

わからなかったら読む。

Read this if you get stuck.

4つの画面、4つの気分。

Four screens, four moods.

ブラウザで動く、あなただけの端末。

Your own terminal,running in a browser.

3つのリンクで動かせる。

Up and running in three links.

自分のMacに、いつでも入れる。

Your own Mac, accessible anytime.

プロダクトで使う機能、全部入り。

Everything you need, built in.

Mac に入れる。ブラウザで開く。それだけ。

Install on your Mac. Open in a browser. That's it.

場所によって URL が変わるだけ。

Only the URL changes by location.

わからなかったら読む。

Read this if you get stuck.

4つの画面、4つの気分。

Four screens, four moods.

ブラウザで動く、
あなただけの端末。

Your own terminal,
running in a browser.