Clearpaths
FAQ Log in Sign up

Help & FAQ

Common questions about Clearpaths. Can't find what you're looking for? Email us.

Support & Feedback

Have a question, found a bug, or want to suggest a feature? Email us at support@clearpaths.pro. We read every message and typically respond within a day.

Getting Started

What is Clearpaths?

Clearpaths is a goal-tracking tool that helps you break big goals into smaller ones, organise them by life area and time horizon, and focus on what's actionable today.

What is a Chapter?

A Chapter is a planning period you define — it could be a quarter, a semester, or any timeframe that works for you. Each Chapter has its own set of Areas, Goal Tiers, and Goals. When a Chapter ends, you start a new one and can carry forward unfinished goals.

How does carrying forward work?

When you start a new Chapter, you can select unfinished goals to carry into it. Clearpaths copies those goals (preserving their hierarchy and blocking relationships) into the new Chapter so you can pick up where you left off. The originals stay in the old Chapter for reference.

What are Areas and Goal Tiers?

Areas are life categories (e.g. Career, Health, Relationships) that help you see where your goals are concentrated. Goal Tiers are time horizons (e.g. Vision, Yearly, Monthly, Weekly) that let you break big aspirations into smaller, actionable steps. You can reorder both by dragging them in their settings pages.

Working with Goals

How do sub-goals work?

Any goal can have child goals beneath it, creating a hierarchy. Completing all sub-goals doesn't auto-complete the parent — you decide when a goal is done. Sub-goals inherit their parent's Area by default but can be reassigned.

What are sequential sub-goals?

Toggle "Run sub-goals one at a time" on a parent goal to chain its children in order. Only the first incomplete child is active — the rest are automatically blocked. When you complete one, the next unblocks. Useful for goals with steps that must happen in sequence.

What does blocking mean?

You can mark one goal as blocked by another — meaning it can't progress until the blocker is resolved. Blocked goals show a visual indicator so you know what's waiting on what. A goal with multiple blockers stays blocked until all of them are completed or cancelled.

What's the difference between completing and cancelling?

Completing marks a goal as finished successfully. Cancelling marks it as abandoned or no longer relevant. Both remove the goal from active views and unblock any goals that were waiting on it. You can optionally add a progress note when completing or cancelling.

How do I defer a goal?

Deferring moves a goal out of your active focus without completing or cancelling it. Deferred goals are hidden from execution views (like Actions) but remain visible in planning views (like the Grid). You can undefer them at any time.

What are progress notes?

Progress notes let you record updates on a goal over time — what you did, what changed, or what's next. They appear on the goal edit page and on the Report page. Notes are plain text and can be added or deleted but not edited.

Can I import goals in bulk?

Yes — on a goal's edit page, you can upload a CSV to create a tree of sub-goals at once. The CSV uses id, parent_id, title, and description columns. Tiers are assigned automatically by depth and areas are inherited from the parent.

Views

What are the different views?

  • List — All goals in a nested tree, with area and status filters
  • Grid — A matrix of Goal Tiers × Areas, showing where your goals sit
  • Actions — Leaf-level goals (no children) that are actionable today
  • Mind Map — A visual tree of your goal hierarchy
  • Timeline — Goals arranged by when they were created or completed
  • Report — Your key goals and their progress notes

Which view should I use?

Start with the Grid to plan and organise, use Actions for daily execution, and check the Report to review progress. The other views are useful for exploration and review.

How do filters work?

Most views have an Area filter dropdown to show only goals in selected areas. The List view has a toggle to show or hide completed and cancelled goals. The Grid lets you pick a tier range to zoom into specific time horizons. Filters persist between visits.

Pricing

How much does Clearpaths cost?

Clearpaths is free during the beta period. No credit card required. We'll give existing users plenty of notice before introducing paid plans.

Is there a fair use policy?

Yes — see the Fair Use Policy. The short version: use it for personal goal tracking, don't abuse the API, don't try to access other people's data.

API & Integrations

Does Clearpaths have an API?

Yes — Clearpaths has a full REST API that lets you create, read, update, and manage goals, areas, goal tiers, chapters, and progress notes programmatically. The API uses bearer token authentication via Laravel Sanctum.

Where can I find the API documentation?

Interactive API documentation is available at https://app.clearpaths.pro/docs/api. It includes request/response schemas for every endpoint and a "Try It" feature you can use with your API token.

How do I get an API token?

Go to your API Tokens page (under your profile menu). Create a token with the permissions you need (e.g. goals:read, goals:write). Copy the token when it's shown — it won't be displayed again. Use it in the Authorization: Bearer <token> header.

What is the MCP server?

The Clearpaths MCP server lets AI assistants (like Claude) interact with your goals directly. It runs as a hosted remote MCP at https://mcp.clearpaths.pro/mcp — point your AI client at it with your Clearpaths API token, no local install needed.