crofty

始める

crofty をインストールして、あとは AI エージェントに渡すだけ。セットアップはこれだけです ── crofty は、あなたが覚えて使うのではなく、アシスタントに動かしてもらうための道具です。

始める前に

1. インストール

macOS（Homebrew）:

brew install ShiroDoromoto/crofty/crofty

Windows（Scoop）:

scoop bucket add crofty https://github.com/ShiroDoromoto/scoop-crofty
scoop install crofty

Linux（.deb / .rpm）── お使いの CPU 向けパッケージを 最新リリース から入手してインストール:

sudo dpkg -i crofty_*_linux_amd64.deb   # Debian/Ubuntu（または _arm64）
sudo rpm -i  crofty_*_linux_amd64.rpm   # Fedora/RHEL/openSUSE

2. エージェントに渡す

ターミナル（コマンドプロンプト）で AI アシスタントを起動し、こう頼むだけです:

crofty agent を実行して

crofty のコマンド全体が出力され、エージェントが読み込みます。最初に〈ブログか、より広いサイト（about・ギャラリー・ショップ・問い合わせなどのページも持つ）か〉をあなたに尋ね、その答えに合わせて以降を一緒に進めます ── プロジェクトの作成、プレビュー、あなた自身のホストへの公開、そして共有用の概要とリンクの用意まで。

ひとつだけ、あなただけの手があります: 公開のとき、crofty がターミナルでホストの認証情報を尋ねます ── Cloudflare の API トークン、または自分のサーバのパスワードか鍵。そこに貼り付けてください ── 認証情報は OS のキーチェーンに保存され、アシスタントを経由することも、crofty に渡ることもありません。

これで全体です。以下はエージェントが crofty agent から既に把握している内容で ── 何をしているか見たい、あるいは自分の手で動かしたいとき用です。

手動フローの全手順

これらを自分で実行する必要はありません ── エージェントが行います。crofty agent がたどる手順そのものです。

サイトを作る ── ゼロから、または Git 管理中の既存フォルダの中で。デプロイ先は既定で Cloudflare。自分のサーバへ公開するなら --provider sftp（または ftps）を渡します:

crofty init        # ~/Documents/Crofty/ の下に新規プロジェクト
crofty init .      # または構成をそのままに、その場でセットアップ
crofty init --provider sftp --host example.com --user me --path /var/www/site

見て、あなた自身のホストへ公開:

crofty preview     # ローカルで開く ── まだアカウント不要
crofty connect     # デプロイ認証情報をキーチェーンに保存
crofty deploy      # あなたのホストへ公開 ── Cloudflare Pages、または自分の SFTP/FTPS サーバ
crofty share       # 概要＋リンクを表示。好きな場所に貼る

下書きと予約公開 ── 標準の Hugo の機能で、crofty 固有のものはありません: draft: true でビルドから外し、未来の date でその日まで保留。crofty build が除外分を一覧で知らせます。

自分のものにする:

crofty theme set quiet-paper   # ほかに: terminal, serif（既定）
crofty theme eject             # 設計トークンを取り出して手で調整
crofty features                # できること一覧と、各機能の有効化方法
crofty add mermaid             # ひとつ有効化（ほかに: abc, highlight, raw-html, analytics）

支援を受けたいときは、data/profile.yml の support に Stripe / GitHub Sponsors / Ko-fi のリンクを書き加えます ── フッタに表示され、お金が crofty を経由することはありません。

アップデート

crofty はインストールした方法でそのまま更新できます:

brew upgrade crofty     # macOS
scoop update crofty     # Windows
sudo dpkg -i crofty_*_linux_amd64.deb   # Linux: 新しい .deb を入れ直す（.rpm は rpm -i）

コンテンツは素の Markdown、テーマは凍結された出力契約なので、更新で書いたものが 書き換わることはありません ── ビルドは crofty doctor が引き続き検証します。新機能は crofty agent に現れるので、あなたのアシスタントは次に読んだときに拾います。覚え直しは不要。

やめたくなったら

囲い込みは一切ありません。コンテンツは素の Markdown、ビルド結果は crofty 無しでも保持・運用できる普通の Hugo サイトです。アンインストールについて →