For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /ja/docs/desktop/terminal-basics.md (or send Accept: text/markdown).
コマンド、ファイル、および設定
コマンドを貼り付ける場所、正しいプロジェクト フォルダーの開き方、.env ファイルの編集、デスクトップ開発コマンドの停止方法、シークレットを共有せずにセットアップ エラーを報告する方法を学びます。
ターミナルにコマンドが入力されます
ターミナルは、コンピュータの指示を入力するウィンドウです。 Visual Studio Code で、まず [ファイル] → [フォルダーを開く] を使用して supastack フォルダーを開き、次に [ターミナル] → [新しいターミナル] を選択します。新しいターミナルはそのフォルダーで起動します。 Windows では、端末の + ボタンの横にあるメニューを使用して、PowerShell を選択します。 macOS または Linux ターミナルで macOS/Linux ブロックを使用します。
コマンド ブロックの内容のみを一度に 1 つずつ貼り付けて、Enter キーを押します。周囲の Markdown バッククォート、PS C:\... などのプロンプト、または出力例を貼り付けないでください。 # で始まる行は説明です。彼らは何も実行しません。各インストール コマンドが完了するまで待ってから、次のコマンドを入力します。サーバー コマンドは実行を継続し、停止するまで新しいプロンプトを返しません。
端末がどのフォルダを使用しているかを確認する
リポジトリ ルートとは、package.json、pnpm-workspace.yaml、アプリおよびパッケージを含む最上位の supastack フォルダーを意味します。ステップに特に記載がない限り、そこでコマンドを実行します。以下のコマンドは、現在のフォルダーを出力します。ファイルのリストには package.json が表示されるはずです。 Windows PowerShell では、pwd と ls も機能します。
一覧に apps/desktop の内容だけが表示される場合は、cd ../.. と入力して Enter を押し、ルートに戻ります。ホーム フォルダーが表示される場合は、cd に続けてスペースとクローンへの完全なパスを入力します。スペースを含む場合は引用符で囲みます。エディターでプロジェクト フォルダーを開き、新しいターミナルを作成する方が通常は簡単です。
pwd
ls設定は端末ではなくファイルに保存されます
AI_PROVIDER=fake のようなブロックは設定テキストです。エディターで名前付きの .env ファイルを開き、AI_PROVIDER= で始まる行を見つけ、その値を置き換えて、Ctrl + S (macOS では Command + S) で保存します。各設定は、KEY=value 形式で 1 行を占めます。 Markdown バッククォートは追加しないでください。 1 つのファイル内で同じキーの重複コピーを避けてください。
データベース移行コマンドにはルートの .env を、Web バックエンドには apps/web/.env.local を使用します — Desktop 専用チェックアウトでは、そのファイルは別のバックエンド リポジトリに属します。デスクトップ シェルは .env ファイルを読みません: SUPASTACK_APP_URL は起動時にコマンド ラインで渡すターミナル環境設定であり、ファイルに保存される構成ではありません。サンプル ファイルは参照用にそのままにしておきます。
名前がドットで始まるファイルは、ファイル マネージャーで非表示になっている可能性があります。エディターのエクスプローラーに表示されます。ファイル名が .env.local.txt ではなく、正確に .env.local であることを確認してください。これらのローカル ファイルにはパスワードが含まれる可能性があり、Git から除外されます。これらをアップロードしたり、その内容をサポート メッセージに貼り付けたりしないでください。
開発コマンドは実行したままにし、コマンドには別のターミナルを使う
デスクトップ開発コマンドは Rust シェルをコンパイルし、実行中にウィンドウを開きます。ウィンドウをテストする間はそのターミナルを開いたままにします。サーバー コマンドは停止するまで実行を続け、新しいプロンプトを返しません。
サーバーがアクティブなときに別のコマンドを実行するには、エディターで [ターミナル] → [新しいターミナル] を選択します。新しいターミナルは、同じプロジェクトへの別のウィンドウです。サーバーを停止するには、そのターミナルを選択し、Ctrl + C を 1 回押します。 Windows では、バッチ ジョブを終了するように求められたら、「Y」と入力して Enter キーを押します。再度開始する前に、通常のプロンプトが表示されるまで待ちます。
シェル設定を変更した後は、Ctrl + C でデスクトップ コマンドを停止し、再度実行します。Rust コアは起動ごとに再コンパイルされます。SUPASTACK_APP_URL の変更は、保存されたファイルを編集するのではなく、次の実行で新しい値を渡すことを意味します。
corepack pnpm --filter @supastack/desktop dev失敗を読んで役立つ助けを求める
インストール中に赤色のエラー テキストが返された場合は、そのステップで停止してください。アプリの起動を続行するのではなく、最初のエラーを読んでください。コマンドが見つからないということは、通常、ツールが見つからないことを意味します。 package.json がない場合は、通常、間違ったフォルダーを意味します。 ECONNREFUSED は通常、必要なサーバーまたはデータベースが実行されていないことを意味します。 EADDRINUSE は、別のプロセスがすでにポートを使用していることを意味します。
ヘルプを求める場合は、オペレーティング システム、ガイド URL とステップ番号、入力した正確なコマンド、および最初のエラー メッセージを含めてください。パスワード、API キー、トークン、およびデータベース URL のパスワード部分を削除します。 .env ファイルは送信しないでください。エラーのスクリーンショットは役に立ちますが、コピー可能なテキストの方が診断が簡単です。