Tarot

Tarot is a VS Code extension that brings a lightweight tarot reading experience into the editor. It uses a left Activity Bar entry as the plugin entrance, opens the full tarot app in an editor tab, and keeps recent readings in the sidebar like small save slots.

Features

• Open the full tarot app directly from the Tarot Activity Bar icon
• Draw cards with multiple spreads inside VS Code
• Browse the tarot card wiki and card details
• Save completed readings to the sidebar automatically
• Reopen or delete past readings from the sidebar
• Copy an AI-ready interpretation prompt after a spread is complete
• Drag the spread board and card drawer viewport when space is limited

How To Use

Activity Bar

Click the Tarot icon in the left Activity Bar.

• The full tarot page opens in the main editor area
• The sidebar works as a reading history panel
• Use New Reading to start a fresh draw
• Click a saved reading to restore it in the editor tab

Command Palette

Open the Command Palette and run:

Tarot: Open Tarot

Reading History

The sidebar stores recent completed readings in VS Code workspace storage.

• Records are saved automatically when a spread is completed
• Each record stores the spread, question, draw result, and timestamp
• Restoring a record reopens the draw result in the main tarot page
• Deleting a record only removes the local saved entry for the current workspace

Development

This project uses nvm to manage Node.js on the local machine.

Switch to the expected Node version first:

nvm use 24.14.1

Install root dependencies:

npm install

Install extension dependencies:

npm --prefix build/extension install

Build the web app:

npm run build

Build the VS Code extension:

npm run build:extension

Package the extension as a .vsix file:

npm run package:extension

Project Info

• Author: LiYuAsam
• Repository: git@github.com:LiYuAsam/Tarot.git
• Homepage: https://github.com/LiYuAsam/Tarot
• License: MIT