クイックスタート

TODO（内部向け・リリース前に対応して削除）

このガイドでは、サンプルのWebアプリケーションをKeelsonにデプロイし、ブラウザでアクセスできることと、ログイン保護がデフォルトで有効になること を確認します。

このガイドを始める前に、次のものを用意してください。

Node.js と npm — ターミナルで node -v と npm -v を実行し、バージョンが表示されればOKです。インストールが必要な場合は Node.js公式サイトから推奨版（LTS）をダウンロードしてください。
Keelson のアカウント — まだの方は keelson.dev からサインアップしてください。
Claude Code や Codex など、Agent Skill を利用できるAIエージェント

インストール後、以下のコマンドで確認してください。

keelson --version

あなたのマシンをKeelsonのアカウントと紐付けます。以下のコマンドを実行してください。

keelson auth login

ブラウザが開き、ログイン画面が表示されます。ログインが完了すると、ターミナルに戻って操作を続けられます。

Keelsonでは、デプロイやデプロイ状態の確認（ログの確認）をAIエージェントに任せることができます。AIエージェントがKeelsonを操作するための Skill を、以下のコマンドでインストールしてください。

npx skills add https://github.com/keelsonhq/agent-skills --skill xxxxxx

デプロイのテスト用に、シンプルなPython (FastAPI) アプリを用意しました。このサンプルアプリには、認証やセキュリティに関するコードは一切含まれていません。

ここがKeelsonの醍醐味です。複雑なコマンドを打つ必要はありません。AIエージェントのチャット欄に、一言こう指示してください。

指示の例: 「Skillを使って、このアプリをKeelsonにデプロイして」

AIエージェントが keelson.yaml を読み取り、自動的にビルドとデプロイを開始します。デプロイには通常1〜2分かかります。その間、AIがサーバーの構築やセキュリティ設定をすべて代行しています。成功すると、AIが以下のような公開URLを教えてくれます。

https://your-app-name.keelson.run/

デプロイされたURLをブラウザで開いてみましょう。

これが Security by Default です。アプリのコードに認証処理を書かなくても、Keelson がデフォルトでログイン保護を適用します。

Keelson 認証画面（アテ画像）