Skip to content

FCR Command — Natural Language Orchestrator

The FCR Command is your single point of control for Full Calendar Remastered.

Usage

Open it from the Command Palette (Ctrl/Cmd + P → "FCR Command") and use natural language to do anything: create events, navigate views, open settings, sync data, and more.


How It Works

  1. Open the Command Palette (Ctrl/Cmd + P)
  2. Search for FCR Command
  3. Type any command in natural language
  4. A live preview shows exactly what will happen before you hit Run
  5. Press Enter or click Run to execute

Everything You Can Do

📅 Create Events

What you type What happens
Team standup tomorrow at 9 am Creates "Team standup" tomorrow at 9:00 AM
next tuesday at 4:30 pm Sprint review Creates "Sprint review" next Tuesday at 4:30 PM
in 3 hours Deploy release Creates "Deploy release" 3 hours from now
in 30 minutes Break Creates "Break" 30 minutes from now
day after tomorrow Workshop Creates "Workshop" two days from now
Matthews 2 in daily1 Creates "Matthews 2" in the "daily1" calendar (smart match)
Meeting in Work calendar Creates "Meeting" in the "Work" calendar (explicit match)
every monday Standup at 9 am Creates recurring "Standup" every Monday
daily Standup Creates "Standup" repeating every day
on 9th at 3 pm for 7 hrs Working Creates "Working" on the upcoming 9th, lasting 7 hours
add event tomorrow Dentist Strips "add event" prefix, creates "Dentist" tomorrow
create event Lunch for 30 mins Strips "create event" prefix, sets duration to 30 mins
category work FINA 3203 N19 at 5pm in work Creates "Work - FINA 3203 N19" at 5:00 PM in calendar "work"
FINA 3203 N19 category work at 5pm in work Same as above, category can be stated at the start or later in the phrase
Focus from 3pm to 5 pm Creates "Focus" with explicit start 3:00 PM and end 5:00 PM
Call at 430pm Parses compact time and creates "Call" at 4:30 PM
What you type What happens
open weekly view Switches to the week view
show month view Switches to the month view
view day view Switches to the day view
open calendar Opens the main calendar tab
open sidebar Opens the calendar sidebar

📆 Go to Date

What you type What happens
go to tomorrow Navigates the calendar to tomorrow's date
goto next tuesday Navigates to next Tuesday
jump to next week Navigates 7 days forward

⚙️ Plugin Orchestration

What you type What happens
open settings Opens Full Calendar settings tab
open chrono / show analyser Opens the Chrono Analyser dashboard (Config)
show changelog / show whats new Displays the changelog
open milestones / show achievements Opens the milestones page
reset cache / clear event cache Clears and rebuilds the event cache
refresh calendars / revalidate remote calendars Resyncs all remote calendars
sync activitywatch / sync aw Pulls latest data from ActivityWatch / TaskNotes

Provider-Aware Create Flow

CREATE_EVENT commands are dispatched through the same provider pipeline used by normal event creation.

  • For local/standard calendar providers, events are created directly in the target source.
  • For TaskNotes providers, creation is delegated to TaskNotes native UI.

This means NLP create commands no longer open an extra intermediate Full Calendar create modal before provider handling.

TaskNotes NLP Endpoint

For TaskNotes calendars, configure the NLP endpoint at Settings → Integrations → TaskNotes Integration:

  • Search + Create (selector modal) (default)
  • Direct Create (task creation modal NLP)

Both modes prefill TaskNotes with parsed NLP text so you can quickly confirm and finalize in TaskNotes-native UI.


Smart Calendar Matching

Input: Tomorrow at 4pm Matthews 2 in daily1

  • If daily1 is a calendar → Title = "Matthews 2", Calendar = "daily1"
  • If daily1 is NOT a calendar → Title = "Matthews 2 in daily1" (left as-is)

You can also use the explicit form in Work calendar which always works regardless of name matching.


Time References

Phrase Meaning
at 4 pm / at 4:30 pm Sets time to 4:00 PM / 4:30 PM
at 430pm Compact format for 4:30 PM
from 3pm to 5 pm Sets explicit start/end time range
at 12 am Midnight (00:00)
at 12 pm Noon (12:00)
at noon 12:00 PM
at midnight 12:00 AM

Date References

Phrase Meaning
today Today's date
tomorrow Tomorrow's date
yesterday Yesterday's date
day after tomorrow Two days from now
next tuesday The upcoming Tuesday (wraps to following week if needed)
next week 7 days from now
next month 30 days from now
in 3 days 3 days from now
in 2 weeks 14 days from now
on 9th / on 4th The upcoming 9th/4th of the month (rolls to next month if day passed)

Duration References

Phrase Meaning
for 1 hr / for 7 hrs Sets event duration to 1 or 7 hours
for 30 mins / for 5 min Sets event duration to 30 or 5 minutes

Combining Phrases

Input: next tuesday at 4 pm Team sync in Work calendar

Result: Title = "Team sync", Date = next Tuesday, Time = 4:00 PM, Calendar = "Work"


Supported Languages

The FCR Command follows the same internationalization pipeline as the rest of the plugin:

  • Maximal support: English
  • Basic support: French, German, Spanish, Italian (help improve it on GitHub)

The language is automatically detected from your Obsidian language setting. Non-English payloads are fetched on first use and cached locally.


Power User Tips

  • Title placement: Put the event title anywhere — the engine strips matched patterns and uses whatever's left.
  • Anchored time parsing: Time is prioritized with at or from triggers to avoid accidental matches from title numbers.
  • Category keyword placement: category <name> works both at the beginning and later in the sentence.
  • Category typo tolerance: Common typos in category <name> are fuzzy-matched to your saved categories.
  • Live preview is your safety net: Always check the preview card before running — it shows exactly what will happen.
  • "in" calendar smart matching: Type in <calendar_name> at the end without needing to write "calendar".
  • Relative date rollover: "on 9th" will resolve to this month if it's the 7th, but next month if it's already the 10th.
  • No match is safe: If the engine doesn't recognize any patterns, the entire input becomes the event title.
  • Time math works: "for 7 hrs" at 3 PM correctly sets the end time to 10 PM.

Troubleshooting

See the Central Troubleshooting Guide for help with command recognition, date resolution, and calendar matching.