このプロジェクトについて

Ticは、無料のオープンソースmacOSアプリで、ToDoリストをメニューバーからデスクトップ上の浮遊する付箋ノートとして表示します。各ノートは独立したチェックリストで、ドラッグ、リサイズ、カスタマイズが可能で、作業中にタスクを表示したままにできます。 ## 主な機能 - **浮遊付箋ノート** – 境界線なし、ドラッグ可能、リサイズ可能なパネル。ノートを他のウィンドウの上に常時表示したり、すべてのスペースで表示したりできます。位置と状態は起動間で記憶されます。 - **複数リスト** – メニューバー、⌘N、ノート内の+ボタン、Dockメニューから新しいリストを作成。新しいリストは自動的に「List 1」「List 2」などと命名されます。 - **リッチタスク** – 最大3レベルまでのサブタスク(親を完了すると子も完了)、複数行メモ(Shift-Return)、インラインMarkdown書式(太字、斜体、コード、取り消し線、リンク)に対応。タップで編集、ドラッグで並べ替え、右にドラッグでネスト。 - **ソリッドまたはリキッドガラスノート** – ノートごとにカラーテーマ、またはデスクトップが透けて見える半透明マテリアルを選択可能。 - **ロールアップ** – ノートのタイトルバーをダブルクリックすると、ヘッダーのみに折りたたみ。 - **Raycast風検索パレット** – 中央に浮遊するコマンドパレットで、任意のリストを検索、開く、削除。完全なキーボードナビゲーション対応。 - **ログイン時に起動** – オプションの自動起動に加え、カスタムメニューバーアイコンとネイティブDock IDを提供。 ## 要件 - macOS 14(Sonoma)以降。 ## インストール 1. [リリースページ](https://github.com/kasvith/tic/releases)から最新の`Tic-vX.Y.Z.zip`をダウンロードし、解凍して`Tic.app`を`/Applications`に移動します。 2. Ticはアドホック署名(公証なし)のため、初回起動時にGatekeeperがブロックする場合があります。次のコマンドでクォータインフラグを解除してください: ```sh xattr -c /Applications/Tic.app ``` その後、通常どおり開きます。または、`Tic.app`を右クリック→「開く」→「開く」を選択します。 3. 自動起動するには、メニューバーメニューから**ログイン時に起動**を有効にします。 ## ソースからのビルド TicはSwift Packageのため、`.xcodeproj`は不要です。 ```sh swift run # ビルド+起動(開発用) swift build -c release # リリースビルド swift test # テストスイート実行(Swift Testing) ./scripts/package.sh # dist/Tic.appを生成(起動するには--openを追加) open Package.swift # Xcodeで編集 ``` ## 使用方法 - メニューバーアイコンは最近のリスト(残りは**その他のリスト**サブメニュー)を表示し、**リストを検索…**、**新規リスト**(⌘N)、**ログイン時に起動**へのクイックアクセスを提供します。 - ノートにホバーすると、コントロール(色、ソリッド/ガラス、最前面に固定、ロールアップ、**+**新規リスト、閉じる)が表示されます。タイトルをクリックして名前を変更、下部フィールドでタスクを追加(Returnでフォーカス維持)。 - タスクにホバーすると**✕**(削除)と**+**行が表示され、クリックでその行の下にサブタスクを追加。空のタスクはクリックを外すと消えます。 ## キーボードショートカット | ショートカット | アクション | | --- | --- | | **Return** | タスクの編集終了/入力したタスクを追加 | | **Shift-Return**(または**⌥ Return**) | 同じタスク内で改行 | | **Shift-Tab** | タスクをサブタスクにする(1レベル深くネスト) | | **⌃ Shift-Tab** | サブタスクのネストを解除(1レベル戻す) | | **⌘N** | 新規リスト | | **タイトルバーをダブルクリック** | ノートを折りたたむ/展開 | タスクをドラッグして並べ替えたり、右にドラッグしてネストしたりできます。ドロップインジケーターで、どこに(どのレベルに)配置されるかが表示されます。編集中は、フィールドに小さなキーキャップヒント(⇧⏎改行、⇧⇥ネスト)が表示されるため、表を覚える必要はありません。 ## アーキテクチャ Ticは、AppKit `NSPanel`内でホストされたSwiftUIビューを使用し(真のデスクトップ固定動作を実現する唯一の方法)、GRDB経由のSQLiteでバックアップされています。`AppModel`コーディネーターがメニューバーとウィンドウレイヤーを橋渡しします。詳細は`CLAUDE.md`を参照してください。 **スタック:** Swift 6 · SwiftUI + AppKit · GRDB (SQLite) · `SMAppService`(ログイン項目)。 ## 開発とリリース - **CI**(`.github/workflows/ci.yml`)は、プッシュ/PRごとにビルド、テスト、Lintを実行。 - **変更ログ**は[Conventional Commits](https://www.conventionalcommits.org)と[git-cliff](https://git-cliff.org)(`cliff.toml`)から生成され、`CHANGELOG.md`に保存されます。 - **リリースはタグベース:** `v*`タグをプッシュすると、リリースワークフローが`Tic.app`をビルドし、リリースノートを生成して、zipアプリを含むGitHubリリースを公開します。 ```sh git tag v0.1.0 && git push origin v0.1.0 ``` アイコンの元アートは`Assets/`(AppIcon / Flat / MenuBar)にあります。 ## ライセンス [MIT License](LICENSE)の下でリリースされています。© 2026 Kasun Vithanage。