InkCalc の使い方

01はじめに #

InkCalc は 計算ノート です。電卓や Numi のような即席のスクラッチパッドとは違い、複数のフォルダ／ノートを長期的に蓄積し、家計、見積、開発メモ、出張試算といった「再訪する計算」を整理して扱えるよう設計されています。

• 1 行 1 式: 改行で式を区切ります。空行とコメントは結果に影響しません。
• 右側に結果: 評価結果は行末のオーバーレイで表示され、本文を汚さずに読めます。
• テキストファイル: ノートは .inkcalc 拡張子のプレーンテキストで、Finder で扱えます。
• AI はオプション: AI 機能は明示的に呼び出した時だけ動作し、設定をオフにすればネットワーク通信は一切行いません。

02クイックスタート #

まずは典型的な家計メモを書いてみましょう。次の 4 行をそのまま入力すると、右側にすべての計算結果が現れます。

# 月の通信費
mobile = 9800
internet = 5500
mobile + internet         # → 15,300
(mobile + internet) * 12  # → 183,600

# や // で始まる行はコメント。x = ... で変数を宣言し、以降の行で再利用できます。これだけで「単発の計算」から「再評価できるメモ」に変わります。

最短ワークフロー

1. サイドバー左下の ＋ で新規ノートを作成。
2. 1 行ずつ式を書く。Enter で次の行へ。
3. 右側に表示される結果を読む。間違いがあれば行末が赤くなる。
4. 自然言語で書きたい時は ⌘⇧I、エラーは ⌘⇧F、まとめは ⌘⇧M、集計は ⌘⇧J。

03基本: 式とメモを並べる #

InkCalc では 1 行が 1 つの独立した式 です。改行ごとに評価が走り、結果が右側の細い列に並びます。空行・コメント行は計算対象になりません（ただし行番号は維持されます）。

3 種類の行

• 式行: 1 + 2 や 30km in mi など。結果が右側に表示されます。
• 代入行: x = 5 のように = を含む行。値を変数に保存します。
• コメント行: # または // で始まる行。メモ用で結果は出ません。

行末の右オーバーレイ

評価結果は行末の余白にうっすら表示されます。コードのように読みやすく、後でテキストをコピーしても結果が混入しません。

04数値・進数・ビット演算 #

進数リテラル

16 進 / 2 進 / 8 進をそのまま書けます。混在させた式も自動で同じ基数の数値として評価されます。

ビット演算

進数表示変換

in hex / in binary / in dec を使うと、結果を別の基数で表示できます。

255 in hex          # → 0xff
10 in binary        # → 0b1010
0xff in dec         # → 255
0b1101 in hex       # → 0xd

05演算子と優先順位 #

優先順位は数学の標準に準拠しつつ、自然言語的なキーワードも組み込まれています。低い順に並べると次の通りです。

全角の × / ÷ や、半角マイナス - と長音っぽい −（U+2212）も同じ扱いになるので、日本語入力の途中でも違和感なく書けます。

06単位 #

数値に単位を付けるとそれは 量（quantity） として扱われ、同じカテゴリの単位どうしで自動換算されます。

単位変換キーワード

in / to / as はすべて同じ意味で使えます。読みやすい方を選んでください。

5 km in miles        # → 3.107 mi
1 kg as lb           # → 2.2046 lb
2 GB to MB           # → 2,000 MB
100 C in F           # → 212 °F
30 min + 45 s        # → 30.75 min

07通貨換算 #

通貨も「単位」の一種として扱われ、起動時にオンラインから最新レートを取得します。再起動なしで リアルタイム に換算できます。

対応通貨

通貨記号と接頭辞

$ € ¥ £ ₩ ₹ はそのまま使えます。$200 は 200 USD と同じ意味です。

100 USD in JPY            # → 15,234 JPY（為替依存）
$50 + €30 in JPY          # 異通貨の合算も換算してから加算
1500円 as USD             # → 9.85 USD
sum(100 USD, 50 EUR) in JPY

08パーセント #

% はその場で割合に変換され、足し算では「増減として」、掛け算では「比率として」振る舞います。これにより自然に消費税や割引を書けます。

09日付と時間 #

日付リテラル

ISO 形式の日付（YYYY-MM-DD）と、英語キーワードが使えます。

日付演算

日付に対して時間単位（days, weeks, year など）を加減算できます。日付どうしを引き算すると days の量が返ります。

2025-04-25 + 7 days       # → 2025-05-02
today + 30 days           # 30 日後
2025-05-02 - 2025-04-25   # → 7 days
tomorrow - today          # → 1 day

10関数と定数 #

定数

関数

sqrt(2)               # → 1.4142
sin(pi / 2)           # → 1
log(1000)             # → 3
avg(85, 92, 78, 90)   # → 86.25

関数は単位付きの値にも適用できます（温度のような offset を持つ単位を除く）。たとえば round(1.7 kg) は 2 kg を返します。

11行参照と集計 #

他の行の結果を参照することで、ノートを 軽量なスプレッドシート のように扱えます。

個別参照

• ans — 直前の行の結果
• line1 line2 … — 指定した行の結果

範囲集計

「これより上の行をすべて集計する」修飾子です。空行・コメント・直前の集計結果は自動的にスキップされます。

100 + 200           # → 300
ans * 1.1           # → 330
500                 # → 500
sum above           # → 1,130
avg above           # → 376.7

12変数とコメント #

name = expression で変数を宣言し、以降の行で何度でも参照できます。再宣言は最新の値で上書きされます。

tax = 10%
price = 1980
price + price * tax     # → 2,178

# 後で税率だけを変えたいときは tax の行を編集する
tax = 8%
price + price * tax     # → 2,138.4

コメント

# または // から行末までがコメントになります。これは AI 機能の 意図推論（⌘⇧J）と組み合わせると強力で、? を含めた質問形のコメントが集計式に展開できます。

# 月の通信費は？        ← ⌘⇧J で AI が下に式を挿入
mobile + internet      # AI が挿入する候補

13AI ショートカット #

InkCalc には 4 つの AI ショートカット があり、いずれも opt-in です。明示的に呼び出した時だけ通信し、入力ライン以外の文脈は最小限しか送りません。

⌘⇧I — 自然言語 → 式

対象行に自然文を書いて ⌘⇧I を押すと、変換シートが開きます。式のプレビューを確認し、置換 ボタンで一発挿入。気に入らなければ閉じるだけで現状維持です。

⌘⇧F — エラー修正

(1 + 2 * 3 のようにカッコ閉じ忘れがあると行末が赤くなります。その状態で ⌘⇧F を押すと、AI が修正候補を提案。差分プレビューで原文と比較し、1 クリックで適用できます。

⌘⇧M — ノート要約

ノートが長くなった時に便利です。AI は 本文だけでなく計算結果も含めて 読み、「月の通信費は 15,300 円で年間 183,600 円」のように、人に伝えられる文に変換します。コピーしてチャットや日報に貼り付けられます。

⌘⇧J — 意図推論

# 月の通信費は？ のような質問コメント行で ⌘⇧J を押すと、AI が関連する変数や行を分析し、質問の直下に集計式を挿入します。計算式そのものを書かなくても、ノートが「答え」を持つようになります。

14AI バックエンドの選び方 #

3 つの AI バックエンドから選べます。設定 → AI から切り替えられ、API キーはすべて macOS Keychain に保管されます。

15ワークスペースと iCloud #

ノートは選択した ワークスペースフォルダ 配下に .inkcalc ファイルとして保存されます。フォルダはローカルでも iCloud Drive でも構いません。

初回セットアップ

1. サイドバー上部のフォルダアイコンから「ワークスペースを開く…」を選択。
2. macOS のオープンパネルで任意のフォルダを指定。
3. 以降、左下の ＋ でそのフォルダ配下にノートを追加。

iCloud Drive 同期

選んだフォルダが iCloud Drive 上にあれば、複数の Mac から同じノートに 自動で アクセスできます。InkCalc は NSFileCoordinator と NSFilePresenter を使い、外部編集の検知と並行書き込みの安全性を確保しています。

16メニューバー / Dock / Always-on-top #

InkCalc は 常駐型の使い方 も想定して設計されています。設定で挙動を切り替えられます。

• メニューバー: ステータスバーに小さな計算機アイコンが常駐し、クリックでウィンドウのトグル。
• Dock 表示の切替: Dock アイコンを非表示にしてメニューバー専用にもできる。
• Always-on-top: ウィンドウを他のアプリの上に常に表示。動画を見ながらの計算、参考資料との並走に便利。

ステータスバーのアイコン

ノート編集中、ステータスバー右下に小さなアイコン群が並びます。それぞれが AI ショートカットへの 1 クリック動線です。

17エクスポート #

ノートはステータスバーから Markdown と CSV の 2 形式で書き出せます。Markdown は日報・議事録に、CSV は表計算ソフトでの後処理にそのまま使えます。

Markdown 出力例

# 月の通信費

```
mobile = 9800            # 9800
internet = 5500          # 5500
mobile + internet        # 15300
(mobile + internet) * 12 # 183600
```

CSV 出力例

line,expression,result
1,"mobile = 9800",9800
2,"internet = 5500",5500
3,"mobile + internet",15300
4,"(mobile + internet) * 12",183600

18設定 #

メニューの「InkCalc → 設定…」（⌘,）から開きます。

表示

• 言語: 日本語 / 英語 / システム設定に従う。再起動不要で即時切替。
• フォントサイズ: エディタ本文の大きさ。
• 小数点以下桁数: 結果オーバーレイの精度。
• テーマ: ダーク基調固定（将来的に切替予定）。

ウィンドウ

• メニューバー常駐
• Dock アイコン表示
• Always-on-top

AI

• バックエンド選択: Apple Intelligence / Claude / OpenAI。
• API キー: Keychain に保存（Claude / OpenAI を選んだ場合のみ）。
• AI 機能の有効化: オフにすると ⌘⇧I/F/M/J は何も送信しません。

19サブスクリプション #

InkCalc は サブスクリプション でフル機能を提供しています。為替レートの安定供給、AI 機能、iCloud 同期、継続アップデートが含まれます。

購入の流れ

1. 初回起動時または設定 → サブスクリプションから Paywall が開く。
2. 無料トライアル対象なら「無料トライアル開始」、それ以外は「購読する」を選択。
3. macOS の StoreKit シートで Apple ID 認証 → 完了。

管理 / 解約

App Store の「サブスクリプション管理」から、いつでも解約できます。期限まではフル機能が使え、期限切れ時に自動で Paywall に切り替わります。

復元

機種変更や再インストール時は、Paywall の 購入を復元 から Apple ID 紐付けの購買履歴を読み込めます。

20ショートカット一覧 #

21FAQ #