Install Taka CLI

CODEBLOCK0

npm release: https://www.npmjs.com/package/taka-cli

---

Property	Value
name	taka
description

AI-powered creative tools CLI for generating images, videos, emails, and flyers |
| allowed-tools | Bash(taka:*) |

---

Core Workflow

The fundamental pattern for using Taka CLI:

1. 1. Authenticate - Log in with your Taka account (email + OTP)
2. Create - Start a new creative project (Instagram post, email, flyer, etc.)
3. Generate - Use AI to generate images, videos, or build content
4. Refine - Update content fields, rename, or regenerate
5. Review - List and inspect your creatives

CODEBLOCK1

---

Authentication

Taka uses email OTP (one-time password) authentication. Tokens are saved locally and auto-refresh silently.

CODEBLOCK2

Environment Variables:

Variable	Required	Default	Description
INLINECODE0	No	INLINECODE1	Custom API endpoint (for staging/dev)

Credentials are saved to ~/.config/taka/config.json with restricted permissions (owner-only read/write).

---

Commands

Creative Management

Create a new creative project
CODEBLOCK3

Types: instagram, email, logo, blog, INLINECODE7

When --prompt is provided for instagram, logo, or flyer types, an image is automatically generated after creation.

List all creatives
CODEBLOCK4

Get a specific creative
CODEBLOCK5

Delete a creative
CODEBLOCK6

Rename a creative

taka rename-creative --creative-id <id> --name "New Name"

Name is limited to 40 characters.

List generated images for a creative

taka list-images --creative-id <id>

---

Image Generation

Generate an image from a text prompt
CODEBLOCK9

Uses Google Gemini AI to generate images.

Options:

• - --prompt <text> (required) - Text description of the image
• INLINECODE10 - One of: 1:1, 3:4, 4:3, 9:16, INLINECODE15
• INLINECODE16 - Attachment IDs for reference images (image-to-image)
• INLINECODE17 - inspire (loose inspiration) or edit (modify in-place)
• INLINECODE20 - Associate the image with a creative project

Examples:

# Square image
taka generate-image --prompt "coffee shop logo" --aspect-ratio 1:1

# Portrait image for Instagram story
taka generate-image --prompt "motivational quote background" --aspect-ratio 9:16

# Associate with a creative
taka generate-image --prompt "product photo" --creative-id abc123

---

Video Generation

Generate a video from a text prompt
CODEBLOCK11

Uses Fal AI to generate videos.

Options:

• - --prompt <text> (required) - Text description of the video
• INLINECODE22 - 5, 7, or 10 (default: 7)
• INLINECODE27 - 16:9, 9:16, or INLINECODE30
• INLINECODE31 - Animate an existing image (image-to-video)
• INLINECODE32 - Associate with a creative project

Examples:

# Short video for Instagram Reels
taka generate-video --prompt "coffee being poured" --duration 5 --aspect-ratio 9:16

# Longer landscape video
taka generate-video --prompt "timelapse of city skyline" --duration 10 --aspect-ratio 16:9

---

Flyer Creation

Generate a hero image for a flyer

taka generate-flyer-image --prompt "grand opening celebration" --creative-id <id>

Always generates in 3:4 (portrait) aspect ratio.

Build a flyer structure
CODEBLOCK14

Template IDs: promo, event, opening, seasonal, minimal, photo-heavy

---

Email Creation

Generate an image for an email section
CODEBLOCK15

Options:

• - --section-id <id> (required) - Section ID within the email
• INLINECODE40 (required) - Image description
• INLINECODE41 - 16:9, 4:3, or INLINECODE44
• INLINECODE45 - Column cell index (0-based, for multi-column sections)
• INLINECODE46 - Associate with a creative

Build a complete email

taka build-email \
  --creative-id <id> \
  --subject "Welcome to Our Newsletter" \
  --preheader "Great things are coming" \
  --global-style '{"backgroundColor":"#f4f4f5","contentWidth":600,"fontFamily":"Arial","fontColor":"#333333"}' \
  --sections '[{"type":"hero","content":{"title":"Welcome!","subtitle":"We are glad you are here"}},{"type":"text","content":{"body":"Lorem ipsum..."}}]' \
  --footer '{"businessName":"My Business","showUnsubscribe":true,"showViewInBrowser":true}'

---

Brand Kit

Get brand images
CODEBLOCK17

Available tags: signature, products, lifestyle, people

---

Content Updates

Update any fields on a creative
CODEBLOCK18

The --fields parameter accepts any valid JSON object with fields specific to the creative type.

---

Common Workflows

Create Instagram Post with AI Image

CODEBLOCK19

Create a Complete Email Campaign

CODEBLOCK20

Create a Promotional Flyer

# 1. Create project
RESULT=$(taka create-creative --name "Grand Opening" --type flyer)
ID=$(echo $RESULT | jq -r '.creative.id')

# 2. Build structure
taka build-flyer --creative-id $ID --template-id opening --headline "Grand Opening" --subtitle "Join us this Saturday"

# 3. Generate hero image
taka generate-flyer-image --prompt "festive grand opening storefront" --creative-id $ID

---

Output Format

All commands output JSON for easy parsing:

CODEBLOCK22

---

Error Handling

Error	Solution
INLINECODE52	Run INLINECODE53
INLINECODE54

Run taka login (refresh token also expired) |
| Not enough credits | Purchase more credits or upgrade plan |
| A video is already being generated | Wait for current video generation to complete |
| Creative not found | Verify creative ID with taka list-creatives |

---

Quick Reference

CODEBLOCK23