CraftBot
One agent. Every kind of work.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/CraftOS-dev/CraftBot with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/CraftOS-dev/CraftBot'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/craftos-dev--craftbot)HTML
<a href="/listings/craftos-dev--craftbot"><img src="/api/listings/craftos-dev--craftbot/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Requirements: Python 3.10+ · Node.js 18+ for browser mode
# 1. Clone the repository git clone https://github.com/CraftOS-dev/CraftBot.git cd CraftBot # 2. Install, register auto-start, and launch CraftBot python craftbot.py install
That's it. The terminal closes itself, CraftBot runs in the background, and the browser opens automatically. A **desktop shortcut** is created so you can reopen the browser anytime.
**Managing the service after install:**
python craftbot.py start # Start CraftBot in the background python craftbot.py stop # Stop CraftBot python craftbot.py restart # Restart CraftBot python craftbot.py status # Check if it's running and if auto-start is enabled python craftbot.py logs # See recent log output python craftbot.py uninstall # Stop, remove auto-start, and uninstall packages
> [!TIP] > After `install` or `start`, a **CraftBot desktop shortcut** is created automatically. If you close the browser, just double-click the shortcut to reopen it.
---
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 230 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- <div align="center">
- <img src="assets/README_cover.png" alt="CraftBot" width="1280"/>
- </div>
- Most agent harnesses stop at chat and tool calls. CraftBot goes further than that. It builds, evolves, and operates its own SaaS tools, then uses that tool layer to communicate and automate with you.
- Beyond that, CraftBot has all the core capabilities of a general-purpose agent harness. It executes tasks the way a remote employee would, remembers your preferences and goals, and proactively helps you plan and act on what matters to you.
- <p align="center">
- <img src="https://img.shields.io/badge/OS-Windows-blue?logo=windows&logoColor=white" alt="Windows">
- <img src="https://img.shields.io/badge/OS-macOS-lightgrey?logo=apple&logoColor=white" alt="macOS">
- <img src="https://img.shields.io/badge/OS-Linux-yellow?logo=linux&logoColor=black" alt="Linux">
- <a href="https://github.com/CraftOS-dev/CraftBot">
- <img src="https://img.shields.io/github/stars/CraftOS-dev/CraftBot?style=social" alt="GitHub Repo stars">
- </a>
- <img src="https://img.shields.io/github/license/CraftOS-dev/CraftBot" alt="License">
- <a href="https://discord.gg/ZN9YHc37HG">
- <img src="https://img.shields.io/badge/Discord-Join%20the%20community-5865F2?logo=discord&logoColor=white" alt="Discord">
- </a>
- <a href="https://deepwiki.com/CraftOS-dev/CraftBot">
- <img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki">
- </a>
- </p>
- <div align="center">
- [](https://e2b.dev/startups)
- </div>
- <p align="center">
- <a href="README.ja.md">日本語</a> | <a href="README.cn.md">简体中文</a> | <a href="README.zh-TW.md">繁體中文</a> | <a href="README.ko.md">한국어</a> | <a href="README.es.md">Español</a> | <a href="README.pt-BR.md">Português</a> | <a href="README.fr.md">Français</a> | <a href="README.de.md">Deutsch</a>
- </p>
- ## ✨ Highlighted Features
- Aside from being an AI agent that can create and operate its own SaaS tools, CraftBot includes all the core features of an agent harness, enabling it to work as a general AI agent alongside you across your tasks, tools, memory, and daily workflows.
- - **Agent Profiles** 40+ Agent Profiles (CEO agent, Finance agent, marketing lead agent, devops engineer, video producer agent, or 37 others) ready to work for you. Find the desire roles from **[CraftBot Agent Bundles](https://github.com/CraftOS-dev/craftbot-agent-bundles)** and import them with one-click.
- - **Playbook catalogue** Not sure how to automate with AI agent? CraftBot has 120 playbooks ready for use (across 19 categories). Open the playbook picker from the top bar, pick a playbook, and it start running task for you.
- - **Agent App.** Build, import, or evolve custom apps that live inside CraftBot. The agent stays aware of the UI's state and can read, write, and act on its data directly.
- - **Multi-tasking and session routing.** Still using `/new` command? CraftBot knows when to start a new session and when to resume a task, keeping conversation and context unified.
- - **Self-hosted and BYOK.** Flexible LLM provider system supporting OpenAI, Google Gemini, Anthropic Claude, OpenRoute, and more. Or host your own model with 0 tokens spent using Ollama.
- - **Memory System.** A second brain built from your interactions with CraftBot. Hybrid approach: RAG + knowledge graph + Agent File System. CraftBot dreams and consolidates events that happened throughout the day at midnight.
- - **Proactive Agent.** Learn your preferences, habits, and life goals. Then, perform planning and initiate tasks (with approval, of course) to help you improve in life.
- - **External Tools Integration.** Connect to your apps like Google Workspace, Slack, Notion, Zoom, LinkedIn, Discord, Telegram and more (more to come!) with OAuth support or your own key. You can connect multiple accounts to each integration.
- - **Skills and MCP.** 150+ MCP and 170+ Skills ready. Quick installation of new Skills and MCPs. Create/improve Skills from completed tasks with one click.
- - **Browser interface and CLI support.** Use CraftBot the way it fits: through a simple browser UI for everyday interaction, or via the CLI for scripting and headless environments.
- ---
- ## 🧰 Getting Started
- Requirements: Python 3.10+ · Node.js 18+ for browser mode
- ```bash
- # 1. Clone the repository
- git clone https://github.com/CraftOS-dev/CraftBot.git
- cd CraftBot
- # 2. Install, register auto-start, and launch CraftBot
- python craftbot.py install
- ```
- That's it. The terminal closes itself, CraftBot runs in the background, and the browser opens automatically. A **desktop shortcut** is created so you can reopen the browser anytime.
- **Managing the service after install:**
- ```bash
- python craftbot.py start # Start CraftBot in the background
- python craftbot.py stop # Stop CraftBot
- python craftbot.py restart # Restart CraftBot
- python craftbot.py status # Check if it's running and if auto-start is enabled
- python craftbot.py logs # See recent log output
- python craftbot.py uninstall # Stop, remove auto-start, and uninstall packages
- ```
- > [!TIP]
- > After `install` or `start`, a **CraftBot desktop shortcut** is created automatically. If you close the browser, just double-click the shortcut to reopen it.
- ---
- ## 🌱 Agent App
- **Agent App is a system/app/dashboard that evolves with your needs.**
- <div align="center">
- <img src="assets/agent-app-showcase.gif" alt="CraftBot Banner" width="1280"/>
- </div>
- - Need a kanban board with an AI co-pilot built in?
- - A custom CRM shaped exactly like your workflow?
- - A company dashboard that CraftBot can read and drive on your behalf?
- Spin it up as a Agent App that runs alongside CraftBot and grows as your needs change.
- ### Three ways to create a Agent App
- 1. **Build from scratch.** Describe what you want in plain language. CraftBot
- scaffolds the data model, backend API, and React UI, then iterates with
- you through a structured design process.
- 2. **Install from the marketplace.** Browse community-built Agent Apps from [living-ui-marketplace](https://github.com/CraftOS-dev/living-ui-marketplace).
- 3. **Import an existing project.** Point CraftBot at a Go, Node.js, Python,
- Rust, or static source code or github repo. It detects the runtime, configures health checks, and wraps it as a Agent App.
- ### Keeps evolving with CraftBot inside the loop
- A Agent App is never "finished." Ask the agent to add features, redesign
- a view, or hook it into new data as your needs grow.
- CraftBot is embedded in every Agent App and **context-aware of its state**:
- it can read the current DOM and form values, query app data through the
- REST API, and trigger actions on your behalf.
- ### Keeps Saas Tools Open and Alive
- Build, customize, and evolve your own Agent App, and rely less on subscription tools that were never built to fit your needs perfectly.
- ---
- # Three Agent Apps to try in 5 minutes
- - **📋 Kanban Board** — Every task, follow-up, and CTA in one place. CraftBot can operate it to perform PM work for you.
- - **📊 Habit Tracker** — Develop and track your habits. Github-style activity calendar to track your habits like a developer.
- - **🐦 Luolinglo** — Not Duolingo, but you can learn new languages, create flashcards, and practice with CraftBot.
- **[Browse and contribute to the Agent App marketplace →](https://craftos.net/marketplace)**
- ---
- ## 🔧 Troubleshooting & Common Issues
- ### Missing Node.js (for Browser Mode)
- If you see **"npm not found in PATH"** when running `python run.py`:
- 1. Download from [nodejs.org](https://nodejs.org/) (choose LTS version)
- 2. Install and restart your terminal
- 3. Run `python run.py` again
- **Alternative:** Use CLI mode instead (no Node.js needed):
- ```bash
- python run.py --cli
- ```
- ### Installation Fails with Dependencies
- The installer now provides detailed error messages with solutions. If installation fails:
- - **Check Python version:** Make sure you have Python 3.10+ (`python --version`)
- - **Check internet:** Dependencies are downloaded during installation
- - **Clear pip cache:** `pip install --upgrade pip` and try again
- ### Playwright Installation Issues
- Playwright chromium installation is optional. If it fails:
- - The agent will **still work fine** for other tasks
- - You can skip it or install later: `playwright install chromium`
- - Only needed for WhatsApp Web integration
- For detailed troubleshooting, see [INSTALLATION_FIX.md](INSTALLATION_FIX.md).
- ---
- ## 🐳 Run with Container
- The repository root included a Docker configuration with Python 3.10, key system packages (including Tesseract for OCR), and all Python dependencies defined in `requirements.txt` so the agent can run consistently in isolated environments.
- Below are the setup instruction of running our agent with container.
- ### Build the image
- From the repository root:
- ```bash
- docker build -t craftbot .
- ```
- ### Run the container
- The image is configured to launch the agent with `python -m app.main` by default. To run it interactively:
- ```bash
- docker run --rm -it craftbot
- ```
- If you need to supply environment variables, pass an env file (for example, based on `.env.example`):
- ```bash
- docker run --rm -it --env-file .env craftbot
- ```
- Mount any directories that should persist outside the container (such as data or cache folders) using `-v`, and adjust ports or additional flags as needed for your deployment. The container ships with system dependencies for OCR (`tesseract`) and common HTTP clients so the agent can work with files and network APIs inside the container.
- By default the image uses Python 3.10 and bundles the Python dependencies from `requirements.txt`, so `python -m app.main` works out of the box.
- ---
- ## 🤝 How to Contribute
- PRs are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for the workflow (fork → branch from `dev` → PR). All pull requests run through lint + smoke-test CI automatically.
- > [!IMPORTANT]
- > **CraftBot** is under active development with weekly improvements. For questions or a faster conversation, join us on [Discord](https://discord.gg/ZN9YHc37HG) or email thamyikfoong(at)craftos.net.
- ---
- ## 🧾 License
- This project is licensed under the [MIT License](LICENSE). You are free to use, host, and monetize this project (you must credit this project in case of distribution and monetization).
- ---
- ## ⭐ Acknowledgements
- Developed and maintained by [CraftOS](https://craftos.net/) and contributors.
- If you find **CraftBot** useful, please ⭐ the repository and share it with others!
- ---
- ## Star History
- <a href="https://star-history.dera.page/#CraftOS-dev/CraftBot&type=date&legend=top-left">
- <picture>
- <source media="(prefers-color-scheme: dark)" srcset="https://star-history.dera.page/svg?repos=CraftOS-dev/CraftBot&type=date&theme=dark&legend=top-left" />
- <source media="(prefers-color-scheme: light)" srcset="https://star-history.dera.page/svg?repos=CraftOS-dev/CraftBot&type=date&legend=top-left" />
- <img alt="Star History Chart" src="https://star-history.dera.page/svg?repos=CraftOS-dev/CraftBot&type=date&legend=top-left" />
- </picture>
- </a>
skills/outlook/scripts/outlook-setup.sh · Bundled script · 251 lines · 1 finding marked
- #!/bin/bash
- # Outlook OAuth Setup via Azure CLI
- # Automatically creates App Registration and configures OAuth
- set -e
- CONFIG_DIR="$HOME/.outlook-mcp"
- CONFIG_FILE="$CONFIG_DIR/config.json"
- CREDS_FILE="$CONFIG_DIR/credentials.json"
- APP_NAME="Clawdbot-Outlook"
- REDIRECT_URI="http://localhost"
- SCOPES="https://graph.microsoft.com/Mail.ReadWrite https://graph.microsoft.com/Mail.Send https://graph.microsoft.com/Calendars.ReadWrite offline_access"
- # Colors
- RED='\033[0;31m'
- GREEN='\033[0;32m'
- YELLOW='\033[1;33m'
- BLUE='\033[0;34m'
- NC='\033[0m' # No Color
- echo -e "${BLUE}=== Outlook OAuth Setup ===${NC}"
- echo ""
- # Check prerequisites
- check_prereqs() {
- if ! command -v az &> /dev/null; then
- echo -e "${RED}Error: Azure CLI not installed${NC}"
- echo "Install with: curl -sL https://aka.ms/InstallAzureCLIDeb | sudo bash"
- Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
- Line 29 on GitHub
- exit 1
- fi
- if ! command -v jq &> /dev/null; then
- echo -e "${RED}Error: jq not installed${NC}"
- echo "Install with: sudo apt install jq"
- exit 1
- fi
- }
- # Step 1: Azure Login
- azure_login() {
- echo -e "${YELLOW}Step 1: Azure Login${NC}"
- # Check if already logged in
- if az account show &> /dev/null; then
- CURRENT_USER=$(az account show --query user.name -o tsv)
- echo -e "Currently logged in as: ${GREEN}$CURRENT_USER${NC}"
- read -p "Continue with this account? [Y/n] " -n 1 -r
- echo
- if [[ $REPLY =~ ^[Nn]$ ]]; then
- az logout 2>/dev/null || true
- else
- return 0
- fi
- fi
- echo "Opening browser for Azure login..."
- echo "(If no browser available, use: az login --use-device-code)"
- if ! az login --use-device-code; then
- echo -e "${RED}Login failed${NC}"
- exit 1
- fi
- echo -e "${GREEN}✓ Logged in successfully${NC}"
- }
- # Step 2: Create App Registration
- create_app() {
- echo ""
- echo -e "${YELLOW}Step 2: Creating App Registration${NC}"
- # Check if app already exists
- EXISTING_APP=$(az ad app list --display-name "$APP_NAME" --query "[0].appId" -o tsv 2>/dev/null)
- if [ -n "$EXISTING_APP" ] && [ "$EXISTING_APP" != "null" ]; then
- echo -e "App '$APP_NAME' already exists: ${BLUE}$EXISTING_APP${NC}"
- read -p "Use existing app? [Y/n] " -n 1 -r
- echo
- if [[ ! $REPLY =~ ^[Nn]$ ]]; then
- APP_ID="$EXISTING_APP"
- echo -e "${GREEN}✓ Using existing app${NC}"
- return 0
- fi
- APP_NAME="$APP_NAME-$(date +%s)"
- echo "Creating new app: $APP_NAME"
- fi
- # Create new app
- APP_RESULT=$(az ad app create \
- --display-name "$APP_NAME" \
- --sign-in-audience "AzureADandPersonalMicrosoftAccount" \
- --web-redirect-uris "$REDIRECT_URI" \
- --query "{appId: appId, objectId: id}" -o json)
- APP_ID=$(echo "$APP_RESULT" | jq -r '.appId')
- echo -e "${GREEN}✓ App created: $APP_ID${NC}"
- }
- # Step 3: Create Client Secret
- create_secret() {
- echo ""
- echo -e "${YELLOW}Step 3: Creating Client Secret${NC}"
- SECRET_RESULT=$(az ad app credential reset \
- --id "$APP_ID" \
- --display-name "clawdbot-secret" \
- --years 2 \
- --query "{clientId: appId, clientSecret: password}" -o json 2>&1)
- CLIENT_ID=$(echo "$SECRET_RESULT" | jq -r '.clientId')
- CLIENT_SECRET=$(echo "$SECRET_RESULT" | jq -r '.clientSecret')
- if [ -z "$CLIENT_SECRET" ] || [ "$CLIENT_SECRET" = "null" ]; then
- echo -e "${RED}Failed to create secret${NC}"
- exit 1
- fi
- echo -e "${GREEN}✓ Secret created${NC}"
- }
- # Step 4: Add API Permissions
- add_permissions() {
- echo ""
- echo -e "${YELLOW}Step 4: Adding API Permissions${NC}"
- # Microsoft Graph API ID
- GRAPH_API="00000003-0000-0000-c000-000000000000"
- # Get permission IDs
- MAIL_RW_ID=$(az ad sp show --id "$GRAPH_API" --query "oauth2PermissionScopes[?value=='Mail.ReadWrite'].id" -o tsv 2>/dev/null)
- MAIL_SEND_ID=$(az ad sp show --id "$GRAPH_API" --query "oauth2PermissionScopes[?value=='Mail.Send'].id" -o tsv 2>/dev/null)
- CAL_RW_ID=$(az ad sp show --id "$GRAPH_API" --query "oauth2PermissionScopes[?value=='Calendars.ReadWrite'].id" -o tsv 2>/dev/null)
- USER_READ_ID=$(az ad sp show --id "$GRAPH_API" --query "oauth2PermissionScopes[?value=='User.Read'].id" -o tsv 2>/dev/null)
- # Add permissions
- az ad app permission add --id "$APP_ID" \
- --api "$GRAPH_API" \
- --api-permissions "$MAIL_RW_ID=Scope" "$MAIL_SEND_ID=Scope" "$CAL_RW_ID=Scope" "$USER_READ_ID=Scope" 2>/dev/null || true
- echo -e "${GREEN}✓ Permissions added (Mail.ReadWrite, Mail.Send, Calendars.ReadWrite, User.Read)${NC}"
- }
- # Step 5: Save Config
- save_config() {
- echo ""
- echo -e "${YELLOW}Step 5: Saving Configuration${NC}"
- mkdir -p "$CONFIG_DIR"
- cat > "$CONFIG_FILE" << EOF
- {
- "client_id": "$CLIENT_ID",
- "client_secret": "$CLIENT_SECRET"
- }
- EOF
- chmod 600 "$CONFIG_FILE"
- echo -e "${GREEN}✓ Config saved to $CONFIG_FILE${NC}"
- }
- # Step 6: User Authorization
- authorize() {
- echo ""
- echo -e "${YELLOW}Step 6: User Authorization${NC}"
- echo ""
- AUTH_URL="https://login.microsoftonline.com/common/oauth2/v2.0/authorize?client_id=$CLIENT_ID&response_type=code&redirect_uri=$REDIRECT_URI&scope=$(echo $SCOPES | sed 's/ /%20/g')&response_mode=query"
- echo "Open this URL in your browser:"
- echo ""
- echo -e "${BLUE}$AUTH_URL${NC}"
- echo ""
- echo "After authorizing, you'll be redirected to a page that won't load."
- echo "Copy the FULL URL from the address bar and paste it here:"
- echo ""
- read -p "URL: " REDIRECT_URL
- # Extract code from URL
- AUTH_CODE=$(echo "$REDIRECT_URL" | grep -oP 'code=\K[^&]+' || echo "")
- if [ -z "$AUTH_CODE" ]; then
- echo -e "${RED}Could not extract authorization code from URL${NC}"
- exit 1
- fi
- echo ""
- echo "Exchanging code for tokens..."
- TOKEN_RESPONSE=$(curl -s -X POST "https://login.microsoftonline.com/common/oauth2/v2.0/token" \
- -H "Content-Type: application/x-www-form-urlencoded" \
- -d "client_id=$CLIENT_ID&client_secret=$CLIENT_SECRET&code=$AUTH_CODE&redirect_uri=$REDIRECT_URI&grant_type=authorization_code&scope=$SCOPES")
- if echo "$TOKEN_RESPONSE" | jq -e '.access_token' > /dev/null 2>&1; then
- echo "$TOKEN_RESPONSE" > "$CREDS_FILE"
- chmod 600 "$CREDS_FILE"
- echo -e "${GREEN}✓ Tokens saved to $CREDS_FILE${NC}"
- else
- echo -e "${RED}Failed to get tokens:${NC}"
- echo "$TOKEN_RESPONSE" | jq '.error_description // .'
- exit 1
- fi
- }
- # Step 7: Test Connection
- test_connection() {
- echo ""
- echo -e "${YELLOW}Step 7: Testing Connection${NC}"
- ACCESS_TOKEN=$(jq -r '.access_token' "$CREDS_FILE")
- INBOX=$(curl -s "https://graph.microsoft.com/v1.0/me/mailFolders/inbox" \
- -H "Authorization: Bearer $ACCESS_TOKEN")
- if echo "$INBOX" | jq -e '.totalItemCount' > /dev/null 2>&1; then
- TOTAL=$(echo "$INBOX" | jq '.totalItemCount')
- UNREAD=$(echo "$INBOX" | jq '.unreadItemCount')
- echo -e "${GREEN}✓ Connection successful!${NC}"
- echo ""
- echo -e "Inbox: ${BLUE}$TOTAL${NC} emails (${YELLOW}$UNREAD${NC} unread)"
- else
- echo -e "${RED}Connection test failed${NC}"
- echo "$INBOX" | jq '.error.message // .'
- exit 1
- fi
- }
- # Main
- main() {
- check_prereqs
- azure_login
- create_app
- create_secret
- add_permissions
- save_config
- authorize
- test_connection
- echo ""
- echo -e "${GREEN}=== Setup Complete! ===${NC}"
- echo ""
- echo "You can now use:"
- echo " outlook-mail.sh inbox - List emails"
- echo " outlook-mail.sh unread - List unread"
- echo " outlook-mail.sh search X - Search emails"
- echo " outlook-calendar.sh today - Today's events"
- echo " outlook-calendar.sh week - This week's events"
- echo " outlook-token.sh refresh - Refresh token"
- }
- main "$@"
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.