日本語 | English

Vibe Terminal Quick Start Guide

Develop on your server from your smartphone. Vibe Terminal is an SSH client designed for the AI era, enabling a new workflow.

This guide covers the basic usage and the flagship feature: Magic Deploy.

Basic Usage

1. Setting Up a Server Connection

After launching the app, register your server connection first.

1. Tap “+ Add Connection”
2. Enter the following information:

• Name: Connection name (e.g., My Dev Server)
• Host: Server hostname or IP address
• Port: SSH port
• Username: Login username
• Authentication: Choose password or key authentication

1. Tap “Save” to save

2. SSH Connection

Tap a registered connection to start an SSH session.

• Connect a physical keyboard for a PC-like command input experience
• Connect to an external display for a large-screen terminal view

3. File Explorer

Open File Explorer from the terminal screen to browse files on the server.

• Starts from the $HOME directory on first open
• The last opened directory is saved and restored on subsequent opens

4. Code Peek

Quickly preview file contents in a modal. Makes code review smooth and efficient.

Magic Deploy: Instantly Install Your Built Apps

Magic Deploy is Vibe Terminal’s flagship feature. It automatically transfers and installs Android apps (APKs) built on your server to your smartphone.

The tedious process of “build complete → transfer APK from PC to phone → install” is completed in one action.

How It Works

Vibe Terminal sets up remote port forwarding during SSH connection, listening on port 58080 on the server side. When an APK path is sent to this port, the app downloads the file via SFTP and begins installation.

Setup Instructions

Step 1: Server-Side Preparation

Ensure the nc (netcat) command is available. It’s installed by default on most Linux distributions.

# Check command
which nc

Step 2: Add Gradle Task (Recommended)

Add the following task to your Android project’s app/build.gradle.kts to automatically trigger deployment when assembleDebug completes.

abstract class NotifyApkPathTask : DefaultTask() {
    @get:javax.inject.Inject
    abstract val execOperations: org.gradle.process.ExecOperations

    @get:InputDirectory
    abstract val apkDirectory: DirectoryProperty

    @TaskAction
    fun notifyPath() {
        val dir = apkDirectory.get().asFile
        val apkFile = dir.walkTopDown()
            .find { it.name.endsWith(".apk") && !it.name.contains("unaligned") }

        if (apkFile != null) {
            val absolutePath = apkFile.absolutePath
            println("Found APK at: $absolutePath")
            try {
                execOperations.exec {
                    commandLine("sh", "-c", "echo \"$absolutePath\" | nc -w 1 localhost 58080")
                    isIgnoreExitValue = true
                }
                println("Sent APK path to localhost:58080")
            } catch (e: Exception) {
                println("Failed to send APK path: ${e.message}")
            }
        }
    }
}

tasks.register<NotifyApkPathTask>("notifyApkPath") {
    apkDirectory.set(layout.buildDirectory.dir("outputs/apk/debug"))
}

afterEvaluate {
    tasks.named("assembleDebug") {
        finalizedBy("notifyApkPath")
    }
}

Usage

Method 1: Gradle Build (Recommended)

After the above setup, just build normally.

./gradlew assembleDebug

When the build completes, Vibe Terminal receives a notification and displays a confirmation dialog. Tap “Install” to download and install the APK.

Method 2: Manual Trigger

You can trigger deployment with a single command without setting up the Gradle task.

echo "/path/to/your/app.apk" | nc localhost 58080

Method 3: Log Output Detection (Legacy)

You can also trigger deployment by monitoring terminal output.

echo ">> VIBE_DEPLOY: /path/to/your/app.apk"

By default, it detects output matching the pattern >> VIBE_DEPLOY: (.*). This pattern can be customized in connection settings.

Tips

Enable Auto-Install

By default, a confirmation dialog appears before APK download, but you can enable auto-install in settings. This is convenient when repeatedly building and installing during development.

External Display Usage

Connect to an external monitor via USB-C or Miracast to display the terminal on a large screen. You can use your smartphone as a touchpad while coding on the big screen.

Summary

With Vibe Terminal, you can complete server development, app building, and testing all from a single smartphone.

The Magic Deploy feature significantly shortens the “build → transfer → install” cycle in Android app development. Combined with AI agents like Claude Code, you can do serious development from your smartphone even while on the move.

Give it a try!

---

Vibe Terminal クイックスタートガイド

スマートフォンからサーバーに接続して開発する。Vibe Terminal はそんな AI 時代の新しいワークフローを実現する SSH クライアントです。

この記事では、基本的な使い方と、目玉機能である Magic Deploy について紹介します。

基本的な使い方

1. サーバー接続の設定

アプリを起動したら、まず接続先サーバーを登録します。

1. 「+ Add Connection」 をタップ
2. 以下の情報を入力：

• Name: 接続名（例: My Dev Server）
• Host: サーバーのホスト名または IP アドレス
• Port: SSH ポート
• Username: ログインユーザー名
• 認証方式: パスワード認証または鍵認証を選択

1. 「Save」 で保存

2. SSH 接続

登録した接続先をタップすると、SSH セッションが開始されます。

• 物理キーボードを接続すれば、PC と同じ感覚でコマンド入力が可能
• 外部ディスプレイに接続すると、大画面でターミナルを表示できます

3. File Explorer

ターミナル画面から File Explorer を開くと、サーバー上のファイルをブラウズできます。

• 初回は $HOME ディレクトリから開始
• 最後に開いたディレクトリは保存され、次回から同じ場所から再開

4. Code Peek

ファイルの内容をモーダルで素早くプレビュー。コードの確認がスムーズに行えます。

Magic Deploy: ビルドしたアプリを即座にインストール

Magic Deploy は Vibe Terminal の目玉機能です。サーバーでビルドした Android アプリ（APK）を、手元のスマートフォンに自動転送・インストールできます。

「ビルド完了 → PCからスマホへAPK転送 → インストール」という手間が、ワンアクションで完了します。

仕組み

Vibe Terminal は SSH 接続時にリモートポートフォワーディングを設定し、サーバー側のポート 58080 をリッスンします。APK のパスをこのポートに送信すると、アプリが SFTP 経由でファイルをダウンロードし、インストールを開始します。

セットアップ手順

Step 1: サーバー側の準備

nc（netcat）コマンドが使えることを確認してください。多くの Linux ディストリビューションではデフォルトでインストールされています。

# 確認コマンド
which nc

Step 2: Gradle タスクの追加

Android プロジェクトの app/build.gradle.kts に以下のタスクを追加すると、assembleDebug 完了時に自動でデプロイがトリガーされます。

abstract class NotifyApkPathTask : DefaultTask() {
    @get:javax.inject.Inject
    abstract val execOperations: org.gradle.process.ExecOperations

    @get:InputDirectory
    abstract val apkDirectory: DirectoryProperty

    @TaskAction
    fun notifyPath() {
        val dir = apkDirectory.get().asFile
        val apkFile = dir.walkTopDown()
            .find { it.name.endsWith(".apk") && !it.name.contains("unaligned") }

        if (apkFile != null) {
            val absolutePath = apkFile.absolutePath
            println("Found APK at: $absolutePath")
            try {
                execOperations.exec {
                    commandLine("sh", "-c", "echo \"$absolutePath\" | nc -w 1 localhost 58080")
                    isIgnoreExitValue = true
                }
                println("Sent APK path to localhost:58080")
            } catch (e: Exception) {
                println("Failed to send APK path: ${e.message}")
            }
        }
    }
}

tasks.register<NotifyApkPathTask>("notifyApkPath") {
    apkDirectory.set(layout.buildDirectory.dir("outputs/apk/debug"))
}

afterEvaluate {
    tasks.named("assembleDebug") {
        finalizedBy("notifyApkPath")
    }
}

使い方

方法 1: Gradle ビルド（推奨）

上記の設定を行った後は、普通にビルドするだけです。

./gradlew assembleDebug

ビルドが完了すると、Vibe Terminal に通知が届き、確認ダイアログが表示されます。「Install」をタップすれば、APK がダウンロードされてインストールが始まります。

方法 2: 手動トリガー

Gradle タスクを設定しなくても、コマンド一発でトリガーできます。

echo "/path/to/your/app.apk" | nc localhost 58080

方法 3: ログ出力検知（レガシー）

ターミナルの出力を監視してデプロイをトリガーする方法もあります。

echo ">> VIBE_DEPLOY: /path/to/your/app.apk"

デフォルトでは >> VIBE_DEPLOY: (.*) というパターンにマッチする出力を検知します。このパターンは接続設定でカスタマイズ可能です。

Tips

自動インストールを有効にする

デフォルトでは APK ダウンロード前に確認ダイアログが表示されますが、設定で自動インストールを有効にすることもできます。開発中に何度もビルド・インストールを繰り返す場合に便利です。

外部ディスプレイ活用

USB-C や Miracast で外部モニターに接続すると、ターミナルを大画面表示できます。スマートフォンをタッチパッド代わりに使いながら、大画面でコーディングするワークフローが実現できます。

まとめ

Vibe Terminal を使えば、スマートフォン一台でサーバー開発からアプリのビルド・テストまで完結できます。

特に Magic Deploy 機能は、Android アプリ開発における「ビルド → 転送 → インストール」のサイクルを大幅に短縮してくれます。Claude Code などの AI エージェントと組み合わせれば、移動中でもスマートフォンから本格的な開発が可能です。

ぜひ試してみてください。