What is Claude Chat?
Claude Chat is the standard web interface at claude.ai. With the Artifacts feature, you can:- ✅ Upload files and binaries
- ✅ Run commands in a sandboxed environment
- ✅ Get instant AI analysis
- ✅ No installation required
Why Use tk with Claude Chat?
Zero Setup
Upload the binary and start using tk immediately — no installation, no configuration
Quick Analysis
Get instant AI-powered recommendations on what to work on next
On-the-Go Access
Access your issues from any device with a web browser
Natural Language
Just ask Claude what you want — it knows how to run tk commands
Setup Instructions
Step 1: Download the tk Binary
Download the Linux x86_64 binary (Claude Chat runs on x86_64 architecture):
This will download the tk-linux-x86_64 binary to your downloads folder.
Or download directly from the install page.
Step 2: Upload Files to Claude
- Go to claude.ai and start a new conversation
- Click the paperclip icon to attach files
- Upload both:
- The
tkbinary you downloaded - Your
.tickets/directory (you can drag and drop the folder)
- The
Step 3: Ask Claude to Set Up tk
Simply ask Claude to make the binary executable and verify it works:
If you see the help output, tk is ready to use!
Usage Examples
Now you can interact with tk naturally through Claude:Get instant triage recommendations
Get instant triage recommendations
You: “What should I work on? Run tk triage and explain the recommendations.”Claude: Runs
./tk triage and analyzes the output, explaining:- Which issues have the highest impact
- What’s blocking the most work
- Quick wins you can knock out
- Overall project health
Analyze dependencies
Analyze dependencies
You: “Show me the dependency tree for tk-abc123 and explain what’s blocking it.”Claude: Runs
./tk dep tree tk-abc123 and explains the dependency chain, identifying blockers.Find ready work
Find ready work
You: “What issues can I start working on right now?”Claude: Runs
./tk ready --limit 10 and shows you all unblocked issues, optionally filtering by priority.Create new issues
Create new issues
You: “Create a high-priority feature issue for adding OAuth authentication”Claude: Runs
./tk create "Add OAuth authentication" -p 1 -t feature and confirms the new issue ID.Get project insights
Get project insights
You: “What are the biggest bottlenecks in this project?”Claude: Runs
./tk insights and explains:- High centrality issues (bottlenecks)
- Critical path analysis
- PageRank priorities
Best Practices
Upload fresh .tickets/ regularly
For the most accurate analysis, re-upload your
.tickets/ directory whenever you make significant changes.Ask follow-up questions
Claude can explain tk’s analytics output in plain English. Don’t hesitate to ask “Why is this issue important?”
Use for planning sessions
Great for sprint planning, roadmap discussions, and project health check-ins.
Combine with local workflow
Use Claude Chat for analysis, then switch to Claude Code for implementation.
Comparison: Chat vs. Cowork vs. Code
| Feature | Claude Chat | Claude Cowork | Claude Code |
|---|---|---|---|
| Architecture | Linux x86_64 | Linux ARM64 | Local machine |
| File Upload | Drag & drop | File picker | Direct access |
| Best For | Quick analysis | Research preview | Full workflow |
| Git Integration | No | No | Yes |
| Persistent Session | Conversation-based | Session-based | Always available |
Limitations
Claude Chat is best for quick triage, one-off analysis, and planning — not as a replacement for your local tk workflow.
Troubleshooting
tk command not found
tk command not found
Make sure you uploaded the binary and asked Claude to run
chmod +x tk. Try: “Make the tk binary executable.”Wrong architecture error
Wrong architecture error
Claude Chat uses Linux x86_64. Download the correct binary:
No .tickets/ directory found
No .tickets/ directory found
Make sure you uploaded your
.tickets/ folder. You can drag and drop the entire directory into the chat.Permission denied
Permission denied
The binary needs execute permissions. Ask Claude: “Run chmod +x tk”