Skip to content

ishaquehassan/goal-agent

Repository files navigation


🎯 Goal Agent

Stop planning your career. Start executing it.


Install in 10 seconds Commands License

macOS Windows Linux

Claude Code Chrome Brave MCP


Any goal · Any niche · Cross-platform · Browser automation built-in


$ /goal:set "Land a senior role at Google"

✅ Goal set: Senior Engineer at Google
📋 Category: job
⏰ Timeline: 4 months

Strategy generated:
  Phase 1 → LeetCode prep, portfolio, profile optimization
  Phase 2 → Articles, LinkedIn engagement, GitHub PRs
  Phase 3 → Referrals, applications, interview prep

Gap Analysis:
  ✅ 13 years experience (exceeds requirement)
  ⚠️  LinkedIn needs optimization for target role
  ❌ No referral connections at Google yet

$ /goal:next

Today's Priorities:
  1. [OPTIMIZE] Fix LinkedIn headline     (20 min)
  2. [ENGAGE] Comment on 3 Google posts   (30 min)
  3. [CONTENT] Write article on system design (2 hr)
  4. [NETWORK] Connect with 2 engineers   (10 min)

It doesn't just plan. It opens your browser, rewrites your LinkedIn, publishes your articles on Medium, comments on the right posts, and tracks every move.


🧠 Researches your goal requirements 📝 Writes articles and posts for you
🔧 Optimizes your LinkedIn/GitHub profiles 💬 Engages with target audience automatically
📊 Tracks progress across sessions 📅 Plans your weekly content calendar
🎯 Prioritizes what to do each day 👥 Manages your professional network


🔥 Works For Any Goal

You bring the ambition. Goal Agent figures out the rest.

Goal Agent auto-detects your goal type and adapts everything: platforms, strategy, targets, content style, engagement approach.

Your Goal What It Does For You
🏆 Developer Expert Programs Targets engineers on LinkedIn, suggests conference talks, tracks PRs on GitHub and articles on Medium
💼 Land a Job at a Top Company LeetCode prep, referral connections on LinkedIn, interview practice, GitHub portfolio
🎬 YouTube 100k Subscribers YouTube content planning, cross-posts to Twitter/X and TikTok, subscriber milestones
💰 Start Freelancing Portfolio building, Upwork/LinkedIn optimization, case study content
🌐 Open Source Maintainer GitHub contribution tracking, project suggestions, Discord community presence
📚 Learn a New Skill Study plans on Udemy, certification tracking, mentor connections on LinkedIn
Something Else Entirely You define the platforms, milestones, and success criteria

Install

macOS / Linux

curl -sL https://raw.githubusercontent.com/ishaquehassan/goal-agent/main/install.sh | bash

Windows (PowerShell)

irm https://raw.githubusercontent.com/ishaquehassan/goal-agent/main/install.ps1 | iex

Manual Install

git clone https://github.com/ishaquehassan/goal-agent.git ~/.claude/plugins/data/goal-agent@ishaquehassan
mkdir -p ~/.claude/commands/goal
for d in ~/.claude/plugins/data/goal-agent@ishaquehassan/skills/goal/*/; do
  cp "$d/SKILL.md" ~/.claude/commands/goal/$(basename "$d").md
done
cp ~/.claude/plugins/data/goal-agent@ishaquehassan/agents/*.md ~/.claude/agents/

The install script uses git if available, otherwise downloads a zip. No prerequisites other than Claude Code itself.


Update

From Claude Code

/goal:update

Checks your installed version, pulls the latest from GitHub, and syncs all commands automatically.

From Terminal

macOS / Linux:

curl -sL https://raw.githubusercontent.com/ishaquehassan/goal-agent/main/update.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/ishaquehassan/goal-agent/main/update.ps1 | iex

Upgrading from v1.0.0? Just re-run the install command. It detects your old installation, upgrades it to the git-based format, and syncs everything. All future updates will work through /goal:update.


How to Use (Daily Flow)

Step 1: Set Your Goal (One Time)

/goal:set "Grow my YouTube channel to 100k subscribers"

It asks your name, role, skills, social links, achievements. Takes 3-5 minutes. Then it researches what's needed, builds your strategy, creates a content calendar, identifies gaps. Everything auto-generated.

Step 2: Check Today's Priorities (Every Day)

/goal:next

Reads all your progress, calculates what's most urgent, gives you top 5 actions with time estimates and tags like [ENGAGE], [CONTENT], [OPTIMIZE].

Step 3: Execute (Pick What Fits Your Day)

/goal:engage 5             # Find target audience posts, comment, follow, react
/goal:write article        # Write a full article, publish to Medium, auto-promote on LinkedIn
/goal:write linkedin-post  # Write and publish a LinkedIn post for your target audience
/goal:optimize linkedin    # Audit your profile against your goal, fix headline/about/skills

Step 4: Log Your Work

/goal:log "commented on 3 posts, published 1 article"

Records what you did, updates your progress percentage, suggests tomorrow's focus.

Step 5: Track Progress

/goal:status

Full dashboard: phase breakdown, KPIs, engagement stats, content tracker, streak, blockers.

Other Commands (When You Need Them)

/goal:research    # Deep dive into goal requirements, find success patterns
/goal:contacts    # Manage your network, see who to reach out to
/goal:calendar    # View and plan your weekly content schedule
/goal:dashboard   # Open the live web dashboard in your browser
/goal:update      # Update to the latest version

Your daily loop: /goal:next to see what to do, execute it, /goal:log to record it. That's it.


Web Dashboard

A Cyberpunk 2077-inspired command center that runs locally with real-time updates, charts, and one-click command execution.

/goal:dashboard

CMD - Mission Overview

CMD - Mission Overview

KPI sliders, phase breakdown, profile radar chart, smart ops with one-click actions, threat board for blockers.


OPS - Operations Log

OPS - Operations Log

Session history with duration and progress badges, milestone tracker with status dots.


INTEL - Content Calendar

INTEL - Content Calendar

Weekly content pipeline grouped by platform, publish status tracking, ideas backlog, one-click "DO IT" buttons.


NET - Network Intelligence

NET - Network Intelligence

Tiered contact list (decision-makers, influencers, peers), company tags, engagement history, follow-up dates.


TERM - Command Terminal

TERM - Command Terminal

Split-panel terminal: command list on left, streaming output on right. Run any goal command from the browser. Browser commands (engage, optimize, write) open in a new terminal window with full MCP access.


Dashboard features:

  • Zero dependencies (pure Node.js, no npm install)
  • Cyberpunk 2077 game-inspired UI with SVG charts
  • Real-time updates via WebSocket when state files change
  • Run all 12 commands directly from the browser
  • Browser commands auto-open interactive terminal sessions
  • Auto-detects goal directory, multi-instance support
  • Works on macOS, Windows, and Linux
  • Requires Node.js 18+

Browser Automation

Three commands use browser automation to execute actions: /goal:optimize, /goal:write, and /goal:engage.

Requirements:

Without the extension: The other 9 commands (set, next, status, log, research, contacts, calendar, dashboard, update) work perfectly fine. You just won't be able to auto-publish or auto-engage from the terminal.

Cross-platform: Browser automation works on macOS, Windows, and Linux. Keyboard shortcuts (Cmd vs Ctrl) are auto-detected.


All Commands Reference

Tracking Layer

Command Description Browser Needed
/goal:set "goal" Initialize goal, profile, strategy No
/goal:next Today's prioritized actions No
/goal:status Full progress dashboard No
/goal:log "work done" Record session work No
/goal:research Deep research requirements No

Execution Layer

Command Description Browser Needed
/goal:optimize [platform] Optimize social profiles (linkedin, github, twitter, all) Yes
/goal:write [type] Create and publish content (article, linkedin-post, cross-post) Yes (for publish)
/goal:engage [count] Engage with target audience (1-10, default: 5) Yes
/goal:contacts Network management No
/goal:calendar Content calendar No

System

Command Description Browser Needed
/goal:dashboard Open the live web dashboard No
/goal:update Update to latest version No
/goal:contribute Submit session learnings as PR to improve the plugin No

Memory Files

Goal Agent stores everything in Claude Code's project memory. These files are auto-created by /goal:set:

File Purpose
goal-profile.md Your background, skills, social links
goal-definition.md Goal statement, category, deadline, success criteria
strategy-roadmap.md Phased milestones with KPIs
progress-tracker.md Session logs, percentage complete
content-calendar.md Weekly content plan
contacts-network.md Tiered professional network
research-findings.md Goal requirements and gap analysis
blockers.md Obstacles and risks
engagement-log.md All comments, reactions, connections
profile-audit.md Profile scores and optimization history

Uninstall

macOS / Linux

rm -rf ~/.claude/plugins/data/goal-agent@ishaquehassan/
rm -rf ~/.claude/commands/goal/
rm -f ~/.claude/agents/goal-researcher.md ~/.claude/agents/engagement-writer.md

Windows (PowerShell)

Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\plugins\data\goal-agent@ishaquehassan\"
Remove-Item -Recurse -Force "$env:USERPROFILE\.claude\commands\goal\"
Remove-Item -Force "$env:USERPROFILE\.claude\agents\goal-researcher.md","$env:USERPROFILE\.claude\agents\engagement-writer.md"

Requirements

Requirement Needed For Install
Claude Code Everything npm i -g @anthropic-ai/claude-code
Claude in Chrome Profile optimization, publishing, engagement Chrome Web Store
Node.js 18+ Web dashboard nodejs.org
LinkedIn account Networking, engagement Log in via Chrome/Brave
GitHub account OSS goals, profile optimization gh CLI recommended
Medium account Article publishing Log in via Chrome/Brave

Built With


License

MIT


Built by Ishaq Hassan

About

Full career goal agent for Claude Code. Set any professional goal, auto-generate strategy, optimize profiles, create content, engage with target audience, track progress across sessions.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors