typefully 0.1.1 → 0.3.0

package/README.md

@@ -1,3 +1,6 @@
+<img src="https://github.com/ahmadawais/typefully-cli/blob/main/.github/cover.png?raw=true" alt="Typefully CLI" />
+
+
 # Typefully CLI
 
 A TypeScript CLI and AI agent skill for drafting, scheduling, and managing social media posts across X, LinkedIn, Threads, Bluesky, and Mastodon.
@@ -42,24 +45,28 @@ typefully setup
 ### 4. Start using it
 
 ```bash
-# Create a tweet
-typefully drafts create --text "Hello, world!"
+tfly                              # interactive — pick text, platform, schedule
+tfly "Hello, world!"              # instant draft from text
 
-# Quick alias — positional text, no flags needed
-typefully create-draft "Hello, world!"
+tfly schedule                     # interactive — browse drafts and schedule one
+tfly rm                           # interactive — pick drafts to delete
+tfly rm <draft_id>                # delete a specific draft
 
-# List scheduled posts
-typefully drafts list --status scheduled
+tfly drafts list --status scheduled
+tfly drafts list --json           # raw JSON for scripts/pipes
+```
 
-# Create a cross-platform post
-typefully drafts create --platform x,linkedin --text "Big announcement!"
+#### Aliases (short forms)
 
-# Schedule for next available slot
-typefully drafts create --text "Scheduled post" --schedule next-free-slot
+| Alias | Equivalent |
+|-------|-----------|
+| `tfly "text"` | `typefully drafts create --text "text"` |
+| `tfly create-draft "text"` | same, with full flag support |
+| `tfly update-draft <id> "text"` | `typefully drafts update` |
+| `tfly rm [draft_id]` | `typefully drafts delete` |
+
+<img src="https://github.com/ahmadawais/typefully-cli/blob/main/.github/image.png?raw=true" alt="Typefully CLI" />
 
-# Output raw JSON (for scripts/pipes)
-typefully drafts list --json
-```
 
 ## Output Modes
 
@@ -96,6 +103,10 @@ typefully config show
 typefully config set-default                            # interactive
 typefully config set-default 123 --location global
 typefully config set-default 123 --scope local         # --scope is an alias for --location
+typefully config set-platforms                         # interactive multiselect
+typefully config set-platforms --platforms x,linkedin,threads
+typefully config set-timezone                          # interactive — pick from common IANA timezones
+typefully config set-timezone --timezone America/New_York
 ```
 
 ### User & Social Sets
@@ -106,6 +117,19 @@ typefully social-sets list
 typefully social-sets get [social_set_id]
 ```
 
+### Interactive Scheduler
+
+```bash
+tfly schedule
+```
+
+Browse all drafts and schedule one with a keyboard-only flow:
+
+- **Happy path** — `↑↓ Enter` pick draft → `Enter` next free slot → `Enter` confirm → `Enter` open in browser
+- **Custom time** — select "Custom date & time", enter date (`YYYY-MM-DD`) and time (`HH:MM`), confirm
+
+Timezone defaults to PST. Change it with `tfly config set-timezone`.
+
 ### Drafts
 
 ```bash
@@ -120,6 +144,7 @@ typefully drafts get <draft_id> --use-default
 typefully drafts get <social_set_id> <draft_id>
 
 # Create
+tfly "Post content"                            # alias for `typefully drafts create --text "Post content"`
 typefully drafts create --text "Post content"
 typefully drafts create -f ./post.txt                  # -f is short for --file
 typefully drafts create --text "..." --platform x,linkedin
@@ -197,7 +222,9 @@ Config files are stored as JSON with `0600` permissions:
 ```json
 {
   "apiKey": "typ_xxxx",
-  "defaultSocialSetId": 12345
+  "defaultSocialSetId": 12345,
+  "defaultPlatforms": ["x", "linkedin"],
+  "defaultTimezone": "America/Los_Angeles"
 }
 ```
 
@@ -232,7 +259,7 @@ npx skills add ahmadawais/typefully-cli
 
 - [Typefully](https://typefully.com)
 - [API Documentation](https://typefully.com/docs/api)
-- [CLI Spec](./CLI-SPEC.md)
+- [CLI Spec](./skills/spec.md)
 
 ## License