@execufunction/cli

@execufunction/cli

Command-line interface for ExecuFunction — AI executive function assistant for tasks, calendar, knowledge, code indexing, and CRM.

Installation

# Run directly
npx @execufunction/cli <command>

# Or install globally
npm install -g @execufunction/cli

Quick Start

1. Authenticate

exf auth login

Or set a Personal Access Token directly:

export EXF_TOKEN=exf_pat_your_token_here

2. Run your first command

exf tasks list
exf tasks create --title "Ship CLI v1"
exf notes search "deployment process"

Command Reference

Auth

Command	Description
exf auth login	Authenticate with ExecuFunction
exf auth logout	Clear stored credentials
exf auth status	Show current auth status

Tasks

Command	Description
exf tasks list	List tasks (filterable by status, project)
exf tasks get <id>	Get task details
exf tasks create	Create a task
exf tasks update <id>	Update a task
exf tasks complete <id>	Mark a task complete
exf tasks delete <id>	Delete a task

Projects

Command	Description
exf projects list	List projects
exf projects create	Create a project
exf projects update <id>	Update a project
exf projects archive <id>	Archive a project
exf projects context <id>	Get full project context

Notes

Command	Description
exf notes list	List notes
exf notes get <id>	Get note with full content
exf notes create	Create a note
exf notes search <query>	Search knowledge base
exf notes update <id>	Update a note
exf notes delete <id>	Delete a note

Calendar

Command	Description
exf calendar list	List events (filterable by date range)
exf calendar create	Create an event
exf calendar update <id>	Update an event
exf calendar delete <id>	Delete an event

People

Command	Description
exf people list	List contacts
exf people search <query>	Search contacts

Vault

Command	Description
exf vault list	List vault entries (metadata only)
exf vault create	Store an encrypted secret
exf vault read <id>	Decrypt and read a secret
exf vault search <query>	Search vault entries
exf vault update <id>	Update entry metadata

Codebase

Command	Description
exf codebase list	List indexed repositories
exf codebase register	Register a repo for indexing
exf codebase status <id>	Check indexing status
exf codebase index <id>	Trigger indexing
exf codebase search <query>	Semantic code search
exf codebase snapshot <id>	Get latest snapshot
exf codebase delete <id>	Delete a repository

Code Tools

Command	Description
exf code history <repo>	Get commit history
exf code who-knows <repo> <area>	Find experts for a code area
exf code blame <file>	Git blame for a file
exf code link <task>	Link a task to code
exf code expertise <repo>	Refresh expertise index
exf code memory store	Store a codebase fact
exf code memory list	List stored facts
exf code memory search <query>	Search stored facts
exf code memory delete <id>	Delete a stored fact

Documents

Command	Description
exf documents upload <file>	Upload a document (PDF, MD, TXT) as a note

Global Flags

Flag	Env Var	Description
--token	EXF_TOKEN	Personal access token
--api-url	EXF_API_URL	API base URL (default: https://execufunction.com)
--json	—	Output raw JSON instead of tables
--no-input	—	Disable interactive prompts

Agent / Script Usage

All commands support --json for structured output, making the CLI composable with other tools:

# List tasks as JSON and filter with jq
exf tasks list --json | jq '.[] | select(.status == "in_progress")'

# Create a task and capture the ID
TASK_ID=$(exf tasks create --title "Deploy v2" --json | jq -r '.task.id')

# Use in CI/CD scripts
export EXF_TOKEN=exf_pat_...
exf tasks complete "$TASK_ID"

Environment Variables

Variable	Description
EXF_TOKEN	Personal access token for authentication
EXF_API_URL	API base URL (default: https://execufunction.com)

License

MIT