Command Codex

Comprehensive manifest for the Workplan AI CLI. Designed for perfect synchronization between terminal and cloud.

Contents

How Workplan AI Thinks

Understanding the agentic reasoning behind your schedule.

Workplan AI isn't just a calendar or a todo list. It's a reasoning engine designed to align your daily actions with your quarterly goals.

When you ask for a plan, we don't just fill slots. We run a multi-step cognitive process:

  • Contextual Deconstruction

    It breaks your high-level goal (e.g., "Ship MVP") into atomic, execution-ready tasks, respecting dependencies.

  • Strategic Sequencing

    It determines the optimal order of operations, ensuring you don't block yourself.

  • Focus Scoring

    It calculates a daily 0-100 score based on task completion, deep work blocks, and distraction minimization.

The Planner Loop

1
INPUT"I need to launch the marketing campaign"
2
REASONINGIdentifying assets, channels, and copy requirements...
3
OUTPUTMon: Draft Copy (2h) → Tue: Design Assets (3h) → Wed: Setup Ads (1h)

Getting Started & Identity

CommandArgumentsOptionsDescription
workplaninit--Initialize .workplan/ storage in current repo.
workplanauth---api-key, --clearManage cloud credentials.
workplanlogin[api_key]-Alias for auth.
workplanlogout--Alias for auth --clear.

Planning & Strategy

CommandArgumentsOptionsDescription
workplanplan[goal]--interactive, -iGenerate/Set weekly tasks via AI.
workplansprint[goal]--show, --set-focus4-week roadmap generation & management.
workplandecomposetask_id--dayBreak task into 5-day micro-steps.
workplanaddtitle--points, --priorityManual task insertion into current plan.
workplanremovetask_id-Remove task from current plan.
workplancarryovertask_id--reasonMark task for the next planning cycle.

Execution & Quick Actions

CommandArgumentsOptionsDescription
workplandonetask_id-Toggle task to done. (Shortcut: d)
workplanstarttask_id-Toggle task to in_progress.
workplanblocktask_id--reasonToggle task to blocked. (Shortcut: b)
workplannotestask_id, text-Append persistent notes to a task.
workplanupdatetask_id--status, --microtaskGranular state updates for tasks/subtasks.
workplantoday--Filter view to today's specific microtasks.

Visibility, Audits & Analytics

CommandArgumentsOptionsDescription
workplandetails---project, --status, --riskMain dashboard view. (Shortcut: ls)
workplanreport---daysGit commit activity vs. Task mapping audit.
workplanstandup---daysAI-generated "Yesterday/Today/Blockers" summary.
workplaneod---sheet, --map, --taskDaily habit tracking & Sheets update.
workplanweekly---daysEnd-of-week executive summary.
workplanretro---daysAnalytical retrospective of the plan cycle.
workplanhealth--Performance metrics (Reliability/Velocity).
workplancheck---daysCommit hygiene & Task-ID tagging audit.
workplandashboard--Global view of all registered projects.
workplantasktask_id--projectFull deep-dive into a single task node.

Sync, Export & Cloud

CommandArgumentsOptionsDescription
workplansync--Push local plan to Google Sheets.
workplansheets[url]--map, --raw-rows, --csvAdvanced Sheets integration & schema mapping.
workplansync-git--Automated Git-to-Task back-sync.
workplancloud-sync---mode (push/pull)Bi-directional Plan synchronization with Cloud.
workplanteam-sync--Publish status to Team Dashboard.
workplanexport[file]--format (csv/json)local data portability.
workplansheets-schema--Introspect remote Sheet columns.
workplanschema-define--Map custom Sheet headers to Workplan fields.

Integrations & Third Parties

CommandArgumentsOptionsDescription
workplanslack---mode, --channelAutomated delivery to Slack channels.
workplangithub---repo, --labelsCreate Issues from Workplan tasks.
workplangithub-sync---repoUpdate local status from Issue state.
workplangithub-push---repoClose Issues for completed local tasks.
workplanjira--Managed Jira ticket synchronization.
workplanintegrations--Check connection health of OAuth services.

Prerequisites & Critical Warnings

  • Internet Access Required: The workplan sheets-export and other integration commands require an active internet connection.
  • Valid API Key: You must be a logged-in user with a valid API key (generated via workplan init).
  • Email Consistency Rule: You must use the SAME Email Address for your Workplan AI account as you do for your integrated tools.

Google Sheets

Export your weekly plan to a formatted Google Sheet. This is perfect for sharing your progress with stakeholders who don't use the CLI.

bash
workplan sheets-export

Slack

Post your End-of-Day (EOD) summary directly to a Slack channel. You can specify a channel or it will default to your configure general channel.

bash
workplan slack-eod --channel #daily-standup

GitHub Issues

Turn a specific task into a GitHub issue. This automatically links the issue URL back to your workplan task for traceability.

bash
workplan github-export owner/repo --task <ID>

Global Configuration

CommandArgumentsOptionsDescription
workplanconfig---tzTimezone & environmental settings.
workplanusage--Token consumption & Tier tracking.
workplanbilling--Access Stripe subscription management.
workplanupgrade--Feature roadmap and tier comparison.
workplanreset-key--Local API Credential removal.
workplanrestore[id]-Plan recovery from local automatic backups.
workplangit-hook---installGit lifecycle automation setup.

Plans & Billing

CommandArgumentsOptionsDescription
workplanusage--Token consumption & Tier tracking.
workplanbilling--Access Stripe subscription management.
workplanupgrade--Feature roadmap and tier comparison.

Upgrade Benefits

Level up your workflow. The Team plan unlocks AI-powered plan decomposition, infinite cloud history, and advanced team analytics.

bash
workplan upgrade

Billing Setup

Manage your subscription easily. Update payment methods, view invoices, or change your plan directly from the dashboard.

bash
workplan billing

Choose the plan that fits your workflow. All plans include core CLI functionality, with premium tiers unlocking AI-powered features, cloud sync, and team collaboration.

Free

₹0

Perfect for hobbyists and trying out Workplan

✓
50 AI calls/month
Basic AI-powered task decomposition
✓
Local CLI Only
All data stored on your machine
✓
Basic Task Management
Create, update, and track tasks
✓
Git Integration
Auto-sync with commit messages
Limitations
  • ✕ No cloud backup
  • ✕ No API access
  • ✕ No team features
MOST POPULAR

Individual

₹399/mo

For solo developers who need unlimited AI power

✓
Everything in Free
All basic features included
✓
Unlimited AI Calls
No monthly limits on AI decomposition
✓
Cloud Sync & Backup
Access your plans from anywhere
✓
API Access
Build custom integrations
✓
Priority Support
Email support within 24 hours
Best For

Freelancers, indie developers, and solo consultants managing multiple projects

Team

₹999/mo

For teams that need collaboration and shared workspaces

✓
Everything in Individual
All premium features included
✓
Team Collaboration
Share plans and track team progress
✓
Shared Workspaces
Centralized project management
✓
Advanced Analytics
Team velocity and health metrics
✓
Role-Based Access
Control permissions per team member
Best For

Small to medium engineering teams (5-20 developers)

Enterprise

Custom

For large organizations with advanced security needs

✓
Everything in Team
All collaboration features included
✓
SSO & SAML
Enterprise authentication integration
✓
Dedicated Success Manager
Personal onboarding and support
✓
SLA Guarantees
99.9% uptime commitment
✓
Custom Integrations
Tailored workflows for your org
✓
Audit Logs
Complete activity tracking
Best For

Large enterprises (20+ developers) with compliance requirements

Frequently Asked Questions

Can I switch plans anytime?

Yes! Upgrade or downgrade at any time. Changes take effect immediately, and we'll prorate your billing.

What payment methods do you accept?

We accept UPI, credit/debit cards, and net banking for Indian customers. International payments via Stripe.

Is there a free trial for paid plans?

Team plan includes a 14-day free trial. Individual plan offers a 7-day money-back guarantee.

What happens to my data if I downgrade?

Your data is never deleted. Cloud-synced data remains accessible for 90 days after downgrade, giving you time to export.

Trust & Privacy

Section 10 • Our commitment to your privacy and intellectual property.

We Never Train on Your IP

Your plans, tasks, and strategies are your intellectual property. We deliberately isolate user contexts and never use your specific data to train our foundational models.

Encryption at Rest & Transit

All data moving between the CLI, our API, and your integrations (Slack, Google, GitHub) is encrypted via TLS 1.3. Database entries are encrypted at rest.

Ephemeral Processing

When you connect an integration, we only fetch what is strictly necessary (e.g., issue titles) to generate your plan. We do not mirror or permanently store your external repo code.

Our Data Promise

  • You own your data. Export it anytime via workplan export or request full deletion.
  • We do not sell your data to third parties. Ever.
  • Your API keys for integrations are stored in a secure vault, separate from application logic.

Global Aliases & Shortcuts

AliasFull Command
lsworkplandetails
psworkplandashboard
inspectworkplantask
pworkplanplan
uworkplanupdate
sworkplansync
dworkplandone
stworkplanstandup
bworkplanblock
tworkplantask

Pro Tip: You can chain shortcuts. For example, workplan d <ID> && workplan s to mark a task done and immediately sync to the cloud.

VisualVortex

Maintain high-performance corporate rhythm. Turn weekly goals into structured roadmaps and automate reporting with our agentic reasoning engine.

Resources

  • Documentation
  • Newsletter
  • PyPI
  • Blog

Connect

  • Contact Us
  • Support Center
  • GitHub

Legal

  • Privacy Policy
  • Terms of Service
  • License (MIT)

© 2026 VisualVortex Creatives. All rights reserved.

Crafted by Sahil Selokar

VisualVortex Logo
VisualVortex
API KeysDocsNewsletterEcosystemSupportPyPI
Log InGet Started