Download Cortex App

The Cortex App lets you run .habit files directly on your device - no server setup required. Import, run, and manage your habits with a native experience.

Desktop & Mobile Apps

Android

Android 8.0+ (ARM64)

Version 1.0.0 · Coming Soon

Coming Soon

Windows

Windows 10/11 (x64)

Version 1.0.0 · Coming Soon

Coming Soon

macOS

macOS 11+ (Intel & Apple Silicon)

Version 1.0.0 · Coming Soon

Coming Soon

Linux

Linux (x64)

Version 1.0.0 · Coming Soon

Coming Soon

How to run .habit files?

How to Run on Mobile

• [ ] Download the Cortex App from store or the downloads page
• [ ] Open the Cortex App on your device
• [ ] Tap "Open Habit" or "+" button
• [ ] Select your .habit file from your device storage
• [ ] The habit will be loaded and ready to run

How to Run on Desktop

• [ ] Download the Cortex App for your platform from the downloads page
• [ ] Install and open the Cortex App
• [ ] Click "Open Habit" or drag & drop your .habit file
• [ ] The habit will be loaded and ready to run
• [ ] Optional: Place a .env file in the same directory as your .habit file to override environment variables

How to Run on Server

Run your .habit file as a server using the Cortex CLI:

# Install and run in one command
npx @ha-bits/cortex --config ./your-app.habit

• [ ] Make sure Node.js 20+ is installed
• [ ] Run the command above with your .habit file path
• [ ] Server will start on the specified port (default: 3000)
• [ ] Access the app at http://localhost:3000
• [ ] Optional: Place a .env file next to your .habit file - it will automatically override any embedded environment variables

How to Run Serverless

For serverless or containerized deployments, we recommend using Docker:

# Using Docker (recommended for serverless)
docker run -p 3000:3000 -v $(pwd)/your-app.habit:/app/habit.habit \
  node:20-alpine npx @ha-bits/cortex --config /app/habit.habit --host 0.0.0.0

Or create a Dockerfile:

FROM node:20-alpine
WORKDIR /app
COPY your-app.habit ./
COPY .env ./ # Optional: include environment variables
RUN npm install -g @ha-bits/cortex
EXPOSE 3000
CMD ["cortex", "--config", "./your-app.habit", "--host", "0.0.0.0"]

• [ ] Create a Dockerfile or use the Docker run command above
• [ ] Deploy to your preferred cloud provider (AWS, GCP, Azure, etc.)
• [ ] Configure environment variables via your cloud provider's secrets management
• [ ] Set up health checks at /habits/base/api endpoint

Alternative: Run via CLI

If you prefer not to install the app, you can run .habit files directly using the Cortex CLI:

# Run any .habit file as a server
npx @ha-bits/cortex --config ./your-app.habit

What's a .habit file?

A .habit file is a self-contained portable package that includes:

• Frontend - The user interface (HTML, CSS, JS)
• Workflows - Backend logic and automations
• Configuration - App settings and metadata

You can generate .habit files from any Habits project using:

npx habits pack --format habit --config ./stack.yaml